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Typographical Conventions Used in this Publication 



Bold facing indicates what you should type. 

Square brackets, [] , indicate a function key, the name of which appears 
in uppercase within the brackets. For example, [RETBN] , [CTRL] , etc. 

Underlining is used for emphasis. 
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Information about this Manual 



Review the following items before you read this publication: 

1. WMCS Introductory User's Manual 

2. WMCS User's Reference Manual 

The subject of this manual 

WMCS system calls and the Keyed Sequential Access Method (KSAM) are 
described for the system programmer's ongoing use of the WMCS operating 
system. 

The audience for whom this publication was written 

Programmers who understand programming fundamentals and who have read the 
WMCS Introductory User's Manual and the WMCS User's Reference Manual. 

Related publications 

The chart on the following page lists other publications about the WMCS 
and the order in which they should be read. 
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Reader's Guide to WMCS Publications 

Instructions: Determine the audience to which you belong and 

then read only the publications at an arrowhead. 

Dotted arrowheads indicate optional reading. 
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CHAPTER 1 
INTRODUCTION 



The Multiuser Control System (MCS) is a general purpose, interactive, 
multi-user operating system developed by WICAT Systems, Inc. for it's 
family of MC68000-based computer systems. The MCS makes available, on 
a microcomputer, features previously available only on large mini, and 
mid-sized computer systems. 



1.1 FEATURES OF THE MCS 

The operating system is divided logically into two parts: 

1 . The scheduler • 

Based upon the priority and status assigned to each 
process, or task, the scheduler gives each process a 
share of the processor resource. 

2. System service calls. 

System service calls are executed only as they are 
called for (explicitly) by a process. They are 
therefore considered extensions of the process. When a 
process calls the operating system, the process 
continues its execution within the MCS; it is as though 
the system service calls were a set of reentrant, 
callable subroutines. Hence, the system calls are not 
an overhead function like the scheduler (that is not 
part of any process and does not contribute to the 
accomplishment of any user task). 

These are the major features of the MCS: 

1. System configuration does not require a complicated 
system generation procedure. For example, device 
drivers can be added and removed using the _MOUNT and 
DISMNT system calls. 
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2. The amount of available memory is the only limitation on 
the number of files that can be open simultaneously, the 
number of processes that can be active simultaneously, 
the number of devices that can be concurrently mounted, 
etc. 

3. A prioritized scheduling algorithm. 

4. The text portion of processes is automatically shared by 
multiple invocations of the same image file. 

5. Memory can be allocated and deallocated dynamically. 
Each process has its own address space. The MCS address 
space is protected from all processes, and processes are 
protected from one another by the hardware memory 
management . 

6. A hierarchichal file structure. 

7. Disk devices support a user-definable disk cache with 
read-ahead capability. 

8. Multiple versions of files. 

9. Logical I/O, i.e., disk files and devices are accessed 
uniformly. 

10. Logical names are fully integrated into the MCS. 

11. A multi-keyed (Keyed Sequential Access Method, KSAM) 
file access program is provided in addition to standard 
random and sequential access methods. 

12. Interprocess communication includes named pipes, mail, 
shared memory, and event flags. 

13. General purpose record locking. 

14. User-assignable, interactive terminal characteristics. 
The standard XONXOFF protocol is supported, and reads 
from the terminal can use any of several edit modes 
including raw data and line reads. Time outs are 
supported so that processes do not hang while waiting 
for input. 



1-2 



Chapter 2 
Directory of WMCS System Calls 



This chapter lists the WMCS system calls by function. For a complete 
alphabetical listing of these system calls, see Appendix A in this 
manual. 



Process Creation 



This set of system calls provides the mechanism for process creation and 
termination. There are two forms of process creation under the WMCS: 

1. Forking. The child process is executed parallel to the parent 
process. 

2. Spawning. The parent process hibernates until the execution of 
the child process is complete. 

Several parameters can be specified during the creation of a process, 
e.g., the scheduling priority for the new process; its standard input, 
output, and error files; a name and a command line. 

__CLCNE Make a duplicate of an existing process. 

_CRPRCS This simplified version of the create process system 
call assumes default values for many of the parameters 
associated with the _CRPROC System Call. 

_CRERQC Create a new process. This is the standard system call 
for process creation. 

_EXPROC Terminates, i.e., removes from the system, the specified 
process. Any open files are closed automatically and 
all memory assigned to the process is made available to 
the system. 
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_JflJLCRPS Allows the creation of multiple copies of a process by 
means of a single image file- This is useful in quickly 
bringing up a single application on several terminals 
simultaneously . 



Process Control 



These system calls are used to manage the attributes of processes 
executing in the system. Note that privileges are required before a 
process can affect processes that do not have the same user id code 
(UIC) . Also, privileges are required to change a processes priority, 
timeslice, operating mode or privileges. 



^ALARM 



_CHSUPER 



_CHUSER 



_CRSHDP 



_CERLC 



_EXITKTN 



_GENGY 



Sets or resets a timer so that, if the specified time is 
reached during the life of the process, the process is 
terminated. 

Change to supervisor mode. If the calling process has 
the correct privilege, its processing mode is changed to 
supervisor. This allows the process to execute 
privileged instructions and to access memory outside of 
its logical address space. After successful execution of 
this system call, the process has virtually unlimited 
access to the system. 

Change the processing mode of the calling process to user 
(this is the inverse of _OiSCJPER) . 

Use this system call to enable or inhibit the crash 
display (stack dump) which normally appears when a 
process performs an illegal operation. 



Enables or disables the use 
process. 



of [CTRL] c to terminate the 



This system call can be used in place of _SETEXIT to 
define an exit handler. If the process uses _SETEXIT to 
define an exit handler, it must use an RTR or RTE 
instruction to return from the exit handler. With 
_JXITRTN the process can return from the exit handler 
with the standard subroutine return statement, RES. This 
allows processes written in high level languages to 
define exit handlers from which they can return. 

Returns, to the calling process, the PID of the specified 
ancestor process. 
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_GET&nR 
_GETEXIT 

_GETPCB 

JGETPID 

_GETPNAM 
_GETPRI 
_GETPFV 
JGEPIMSL 



.JEBERN 

_ORIGFKV 

.PIDLST 
.JPRCLST 
_PRIRAT 



_SETATTR 
_SETEXIT 



Returns the current process attributes. 

Returns , to the calling process, the address of the 
current exit handler. 



Returns , to the calling process, the Process 
Block (PCB) of the specified process. 



Control 



Returns the Process Identification number (PID) of the 
process whose name is specified as part of this system 
call. 

Returns the name of the process assigned to the PID 
specified as part of this system call. 

Returns the priority level of the process assigned to the 
PID specified as part of this system call. 

Returns the privilege mask assigned to the process whose 
PID is specified as part of this system call. 

Returns the timeslice assigned to the process whose PID 
is specified as part of this system call. The timeslice 
is the maximum amount of time a process is allowed to run 
before it is interrupted so that another process can run. 



Use WAKE to 
Note that a 



cause the 
suspended 



Suspends the specified process, 
suspended process to resume, 
process cannot wake itself. 

This system call returns the privilege a process has, not 
including any privileges with which it may have been 
installed. 

Returns the PIDs of all processes on all priorities and 
the total number of processes running on your machine. 

Returns the PIDs of those processes assigned to the 
priority level designated as part of this system call. 

Assigns the scheduling ratios for each priority level. 
The scheduling ratio determines the number of processes 
at a particular priority level that will be executed for 
each process at the next lower level. 

Set process attributes. 

Allows a process to specify the execution of a procedure 
or subroutine before the termination of the calling 
process. This is particularly useful in recovering from 
errors. 
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_SETPNAM 

_SETPRI 
_SETPRV 
_JSETRTM 



.JSETTMSL 



_WAIT 
JWAKE 
_WAKEC 



Changes the name of the process assigned to the PID 
specified as part of this system call. 

Changes the priority level of the specified process. 

Changes the privileges assigned to the specified process. 

Immunizes the specified process from interruptions by the 
scheduler, i.e., with the real-time mode flag set, the 
process runs until it either relinquishes the CPU, or is 
blocked due to input or output not being received in 
time. 

Adjusts the timeslice associated with the specified 
process. The timeslice is the maximum amount of time a 
process is allowed to run before being interrupted so 
that another process can run. 

Allows a user process to take advantage of the MC68000 
trap instructions, and to handle certain hardware 
exceptions, e.g., a divide-by-zero. 

Suspends the designated process for a specified period. 

Wakes a hibernated process. 

Decrements the hibernate count of the specified process. 
If the hibernate count goes to zero, the specified 
process is awakened. Contrast this with JWAKE. 



File System 



One of the major functions of the file system is to insulate user 
processes from the details of physically accessing I/O devices. It is 
also advantageous if a program can read from and write to terminals, 
printers, etc., using those system calls used to access files on a disk. 

These capabilities are referred to as device-independent I/O, or logical 
I/O. In other words, this allows the program to manipulate files without 
having to consider most of the particular characteristics of the device 
on which the file is located. The WMCS provides logical I/O for reading 
and writing devices, files, as well as named pipes (interprocess) . 

_CHDIR Designates the working-default device and directory for 
the calling process. 
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_CLOSE 

_CREATE 

.CREATES 

JDELETE 
_DUILUN 

_i"REWAIT 



Qoses the specified file, i.e., makes 
inaccessible to read and write operations. 



the file 



_GETDIR 

_GETPCB 
_GETFID 

JGETFNAM 

_GETFRSZ 
_GETFOS 

_JjOCK 
_OPEN 



Creates a file and assigns it the attributes specified as 
part of this system call, then opens the file. 

This simplified version of .CREATE creates a file and 
assigns it default values for many of the _CREATE 
parameters. 



Deletes the specified file. 

Copy the LUN from _OPEN 
opening) . 



or .CREATE (similar to re- 



Waits for the completion of a fast read. A fast read 
means that one or more sectors are read directly into the 
logical address space assigned to the process (bypassing 
the disk cache) . Inasmuch as this happens 
asynchronously, this system call allows the calling 
process to verify that the data are available before the 
data are accessed. 

Returns a string containing the name of the default 
device and the name of the default directory for the 
calling process. 

Returns the PCB of a file opened fcy the calling process. 

Returns the file ID, to the calling process, of the 
specified process. 

A process can use this system call to determine the name 
of an open file. 

Returns the record size of an open file. 

Returns the relative record position (relative to the 
front of the file) of the next record in the file to be 
read or written. 

Allows the process to lock records within a specified 
file to be used exclusively by the calling process. 

Makes the specified file accessible to read and/or write 
operations. A file can be opened for read and/or write 
operations and (optionally) for exclusive access by the 
calling person. Files can also be shared. 
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_£EAD Reads records from an open file into the specified 
buffer. 

..RENAME Changes the name of the specified file. 

_SETPCB Allows the calling process to modify the File Control 
Block of an open file. 

_SETFID Allows the calling process to specify the file ID of an 
open file. 

_SETFRSZ Allows the calling process to change the record size of 
an open file. 

_SETFOS Allows the process to position a file. This is not 
required for random access to files. JREAD and JWRITE 
allow the specification of those records to be 
transferred. 

_UNLOCK Unlocks records in an open file. 

_WRITE Writes records from the specified buffer to the file. 



Device Control 



The following set of system calls allow a process to mount, dismount, 
access and set attributes on devices. 

_ALLOC Use this system call to allocate or reserve a device for 
the exclusive use of a process and its subprocesses. 

_DEALLOC Deallocate a device that was allocated using the _JUJOC 
system call. 

_J)ISMNT Removes the device from the cognizance of the WMCS. 

_JLUSH Flushes I/O buffers to the device. Any modified sectors 
or FCBs are written to the device. 

__GETALC This system call allows a process to retrieve the names 
of devices allocated to a specified process. 

jGETONAM Returns the name of the nth device in the list of mounted 
devices. 

jGETOST Returns the device table and device status block for the 
specified device. 
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_GETREL 
_GE1RTR 
_GIODST 



_J1EMMNT 

_JOJNT 

_i>HYSIO 
_iHYSOP 
_3ETDST 

_SEEOT 
_SIODST 



Given the name of a rotor ed device, this system call will 
retrieve the names of all devices assigned to that rotor. 



This system call allows a process to 
of all currently defined rotor lists. 



retrieve the names 



This system call is the same as jGEIDST except that it 
requires the logical unit number dun) of an open file on 
the device instead of the device name. This is a more 
efficient mechanism than jGEIDST. 

Makes a device or pipe known to the file system and, if 
necessary, loads the device driver from a specified 
location in system memory. 

Makes a device or pipe known to the file system and, if 
necessary, loads the device driver from the specified 
file. 

Allows the process to perform physical I/O operations on 
the device, e.g., reading and writing sectors. 

Allows the process to perform physical I/O operations on 
the device, e.g. , reading and writing sectors. 



Allows the process to update the device 
the specified device, and is used to 
device characteristics as baud rate. 



status block of 
establish such 



J3KIP 



Defines a rotor list and assigns the names of the devices 
that are associated with the rotor. 

Similar to _SEIDST except that the device whose status is 
to be set is specified by a logical unit number of an 
open file on the device instead of the device name. This 
is more efficient than JSEIDST. Allows the process to 
update the device status block of the specified device, 
and is used to establish such device characteristics as 
baud rate. 

Allows the process to position the tape at the beginning 
or end of the tape, or to skip files. 
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KSAM 



The Keyed Sequential Access Method (KSAM) is an optional WMCS module that 
can be included in the system's configuration when the system is booted. 
It allows files to be accessed on the basis of key values, an access 
method that enhances the standard random access provided by the file 
system. Its more important features include: 

Multi-user access to KSAM files 
Record-level locking 
Deadlock detection 
Multiple keys 
Segmented keys 

Each KSAM file is maintained as two separate files; one containing the 
keys and the second containing the data. 

Keys can be composed of any number of signed or unsigned bytes, words, or 
longwords (up to a maximum of 255 bytes) • 

Programs can find a record containing a specified key value, or read a 
file in ascending or descending order for any key. 

"KSAM file" in the following list of KSAM system calls refers to the KSAM 
key file and the KSAM data file. 

_KCLALL Closes all KSAM files opened by the calling process. 

_KCLOSE Closes a KSAM file. 

JKCREAT Creates a KSAM file. This includes a definition of all 
the key fields in the records constituting the new file. 

_KDELET Deletes the current record from the KSAM file. 

_KFIND Finds the record that contains the specified key value. 

_j(FLUSH Writes all modified KSAM buffers to the disk. 

_jaNPO Returns information about an open KSAM file. 

_KMCVEB Positions (logically) the KSAM file at its beginning or 
end, according to the specified key. 

_KDPEN Opens an existing KSAM file for access. 

__KREAD Retrieves a record from an open KSAM file. 
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_KDNLCK Unlocks the specified KSAM records. 

_JCDHDAT Replaces a KSAM record, in an open KSAM file, with the 
specified record. 

JKWRTTE Adds a new record to an open KSAM file. 



Memory Control 



The following 
memory. 

.JVLLMEM 



_PEFMEM 



_PREMEM 

_GETFRE 

_GEIMLST 

^MAPPHYS 

_PRO0MEM 

_j?DPMEM 

.J3HRMEM 

_UDE*WEM 

_USHRMEM 



system calls allow the process to manage the system's 



Adds a new page of memory to the process, or allows the 
process to share a page of memory with another process. 

Define a named shareable memory segment. Once a named 
memory segment has been defined, other processes may 
request that that segment be mapped into their address 
space. 

Deallocates a page of memory, i.e., returns the page to 
the system's pool of available memory. 

Assigns the amount of available memory to the calling 
process. 

This system call allows a process to retrieve the names 
of currently defined named shared memory segments. 

This system call allows a process to map any physical 
segment of memory into its logical address space. 

Sets or clears the write-protect flag on a page of 
logical memory. 

Allows the process to read the values stored in the 
specified locations in physical memory. 

Maps the specified named shareable memory segment to the 
logical address space of the calling process. 

Removes the definition for the specified named shareable 
memory segment from the operating system. This is the 
inverse of _£EFMEM. 

Removes the memory associated with the specified named 
shareable memory segment from the logical address space 
of the calling process. Hiis is the inverse of _SHRMEM 
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_WTPMEM Allows the process to write values to the specified 
locations in physical memory. 



Logical Names 



The following system calls allow processes to assign , deassign, and 
retrieve logical names. A logical name is a string equivalence. 

..ASSIGN Assigns a logical name in the logical name table for the 
specified process. 

jGASSIGN Assigns a logical name in the system's logical name 
table. 

jGETCIB Allows the process to retrieve the nth logical name from 
the system's logical name table. 

_GEILOG Allows the process to retrieve the nth logical name from 
the logical name table for the specified process. 

_TRANPID Returns the Equivalence assigned to the specified Name. 
Note that this is similar to _TRANS except that this 
system call uses the logical name table of a specified 
process and its parents , instead of the logical name 
table of the calling process. 

_TOANS Returns the Equivalence assigned to the specified Name. 
First , the logical name table for the calling process is 
searched. If no Equivalence is found, the logical name 
table for the parent of the calling process is searched. 
The search continues until an Equivalence is found , or 
until there are no more parent processes. At that time, 
the system's logical name table is searched. If no 
Equivalence is found, the original string is returned as 
the translation. 



Ownership 



The following system calls are used to find out or specify the ownership 
of files, devices, or processes (all files, devices, and processes have 
an owner) . Ownership is determined fcy a User Identification Code, or 
UIC. The UIC is composed of an owner ID and a group ID. 
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JDEFDUIC Establishes the default device ownership. Whenever the 
device is not being referenced by any process the user 
identification code (UIC) of the device is set to this 
value. 

_GEHXJIC Returns the UIC for the specified device. 

_GEEFUIC Returns the UIC for the specified file. 

_GETOIC Returns the UIC for the specified process. 

_3ETDUIC Assigns a UIC to the specified device (this changes the 
ownership of the file) . 

JSEEFUIC Set file UIC. This changes the ownership of the file. 

JSETMUIC Assigns a UIC to the specified named memory segment. 

JSETOIC Assigns a UIC to the specified process (this changes the 
ownership of the specified process) . 



Protection 



The following system calls are used to find out or assign device and file 
protection. Protection is actually a matter of the access privileges 
granted (to a process) by the owner of the device or file. Processes 
fall into four categories , based on the owner of the process and the 
process's privilege mask: 

1. A process created by the owner of the file or device. 

2. Processes created fcy members of the same group to which the 
owner belongs. 

3. Processes with SYSTEM privilege. 

4. All other processes, i.e., the Public. 

_JDEFDPRT Establishes the default protection to be applied to a 
device. Whenever the device is not being referenced fcy 
any process, the protection mask will be set to this 
value. 

__PEFPROT Establishes the default protection to be assigned to files 
or devices created, by the specified process, when 
protection is not specified. 
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_GEEDPRT Returns the protection flag word associated with the 
specified device. 

_GEEFPRT Returns the protection flag word associated with the 
specified file. 

_GETPR0T Returns a default protection mask associated with the 
calling process. 

.JSEIDPRT Assigns the specified value as the protection flag word 
for the designated device. 

_SETFPRT Assigns the specified value as the protection flag word 
for the designated file. 

JSETMPKT Assigns the specified value as the protection flag word 
for the designated memory segment. 



Interprocess Communication 



These system calls signal events and send messages between cooperating 
processes. 

.JVNDEVOT Waits for the logical AND of event flags. The calling 
process is suspended until all of the specified bits are 
set in the event flag word of the specified process. 

_CLREVMT Clears the specified bits in the event flag word of 
specified process. 

_GETEVMT Transfers the event flag word of the specified process to 
the calling process. 

_GMAIL Returns a message (sent to the specified process) to the 
calling process. 

_OREVNT Waits for the logical OR of event flags. The calling 
process is suspended until any of the specified bits are 
set in the event flag word of the specified process. 

.JSETEVMT Sets bits in the event flag word of the specified process. 

JSMAIL Allows the calling process to send mail to another 
process. 
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Installed Files 

An installed file is an image file that must execute with more privileges 
than the parent process may have. In other words , an installed process 
executes with privileges that the user running the process does not 
possess. 

Furthermore, a device driver can be installed, meaning that a process 
with no privileges can mount a device using that driver. 

The following system calls allow processes to install and remove 
privileged files. 

_J)EINST Removes a privileged file from the list of installed 
files. 

jGETINSr Retrieves the definition of the nth installed file. 
..INSTALL Installs the specified privileged file. 



Information 



These system calls are used to set the system clock and to get the 
system's time of day, the system's tick clock, and the WMCS version 
banner. 

_ERRNO The WMCS will pass control to the exit handler of a process 
when the process is about to be terminated. _£RRNO is used 
to determine the cause of the termination, or the abort 
reason code. 

__GETTIC Returns the value of the system's tick clock, which shows 
how much time has elapsed since the system was booted. The 
time is expressed as the number of .01 seconds that have 
elapsed. 

_GEPTIM Returns the date and time according to the system's time- 
of-day clock. 

.JSETTIM Sets the system's time-of-day clock. 

_VERSION Returns a string containing the WMGS version banner, which 
contains a copyright notice and the revision number of the 
version of the WMCS running on your system. 
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Floating Point 



_J*APFP A process uses this system call to map the physical address 
of a hardware floating point device into its logical 
address space. 



Networking 

The following system calls allow processes to execute on a remote 
computer. 

_GONNECT Make a connection to a remote machine. 

JXBNALL Break all remote connections. 

JXENUXE Break all idle remote connections. 

JDISGONN Break a remote connection. 

_GEENNAM Get a nodename from a site ID. 

__GEENSID Get a site ID from a nodename. 

_J?NIDLST Return a list of all known remote ID numbers. 

_J*SIDLST Get a list of site IDs from a remote network. 

_3IDLST Return a list of all known site ID numbers on the current 
network. 

Important Features of the System Call Library 

The system call library is a set of procedures that allow programs 
written in C, FORTRAN, Assembler and Pascal to call the WMCS. The 
interface (system call name, parameter definition, parameter sequence, 
etc.) is uniform for each language. 

Furthermore, a set of system table definitions is released with the WMCS. 
These files contain the structure or record definitions of all WMCS 
tables for Assembler, C, and Pascal. These files can be included in any 
program that refers to system tables, to provide up-to-date definitions. 
Note that this is particularly useful for systems integrators who write 
device drivers. 
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CHAPTER 3 
DICTIONARY OF SYSTEM CALLS 



alarm 

Set alarm clock 

Description: 

Sets an alarm clock. When the system clock becomes greater 
than or equal to the specified value, the process will be 
terminated. Time is in the 64 bit system time format 
(absolute time or delta time). 

The absolute time format of the date and time within these 
8 bytes is as follows, where byte is the most significant 
byte. 

Bytes Description 

0,1 The current year (counted from A.D. 0). Example, 1983. 

2,3 The day of the year (1..365 or 1..366) 

4 The hour of the day (0..23) 

5 The minute of the hour (0..59) 

6 The second of the minute (0..59) 

7 The fraction of a second (in 100'ths of a second) (0..99) 

For delta time, the most significant long word is (-1). 
The least significant long word is a negative number whose 
absolute value is the number of ticks (.01 seconds per tick) 
from the current time. 

Alarm clocks may be set only for the current process. 

There can be only one alarm time per process. When _alarm is 
called, the previous setting is replaced with the new value. 

Setting the alarm time to resets (disables) the alarm clock. 
Related Privileges: 

None. 

Parameters : 

mstime - Most significant 32 bits of clock value 
lstime - Least significant 32 bits of clock value 

Diagnostics: 

None . 

See Also: 

wait - Pause for a period of time 
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alarm 



Assembler Calling Sequence: 



push 


mstime 


push 


Is time 


jsr 


__alarm 



C function declaration: 



void 

_alarm(mstime, lstime) 

long mstime; 

long lstime; 

Fortran Subroutine Declaration 



;value - most significant time bits 
;value - least significant time bits 
;set alarm clock 



/* set alarm clock */ 
/* no result */ 

/* most significant time bits */ 
/* least significant time bits */ 



! set alarm clock 
subroutine alarm (mstime, lstime) 

integer*4 mstime ! most significant time bits 
integer*4 lstime ! least significant time bits 



Pascal procedure declaration: 

procedure _alarm( 

mstime : longint; 

lstime : longint 
); external; 



{** Set alarm clock } 

{** most significant time bits } 

{** least significant time bits } 
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..ALLOC 
Allocate a device. 

Description: 

This system call is used to allocate a device for the exclusive use 
of a specified process and any spawned subprocesses of that process 
(see _crproc) . Once a device is successfully allocated/ other 
processes may not access that device except to read the device status 
(_getdst) and to flush the cache buffers (_flush) . 

A device may be allocated to at most one process. Subprocesses of 
the process to which the device is allocated will be able to access 
the device as though it were allocated to them. 

To be successfully allocated , the specified device must not be 
currently referenced by any process. That is, the device must not be 
open by any other process. _getdst, _setdst, _physop, and other 
device operations also cause a device to be momentarily referenced. 
If the device is a virtual circuit (X.25) the device may not have an 
incoming session pending. 

"Hie device to be allocated may reside on any node to which the 
process has access. 

Hie calling process also specifies the intended use (read operations/ 
and/or write operations) of the device. The specified process must 
have access to the device for the intended use before the device can 
be alloced. For instance , if the intended use of the device is for 
read operations, the specified process must have read privilege to 
the device. 

The calling process must have access to the process to which the 
device will be allocated. For instance, a process which does not 
have either world or group privilege may allocate a device to itself, 
or to any other process with the same user identification code. 

If the specified device name is the name of a rotor list, this system 
call will select a device from the list that is currently not in use 
and to which the specified process has appropriate access (read 
privilege/write privilege) . 
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_alloc 



Hie time out parameter is used to specify the maximum amount of time 
the calling process is willing to wait for the specified device (or a 
suitable device from the specified rotor list) to become available 
for allocation. The specified device (or the suitable devices on the 
specified rotor list) is checked once per second until it becomes 
available, or the time out expires. Note that if the specified 
process does not have access to the device (according to the 
specified intended use) the time out does not apply. That is, a non- 
zero status is returned to the calling process immediately, without 
waiting for the time out to expire. 



Related Privileges: 



none 



group 
world 



Parameters: 



- Allows allocation of devices to a process with the same 
user identification code (UIC) as the calling process. 

- Allows allocation of devices to processes which have the 
same group id as the calling process. 

- Allows allocation of devices to any process whatsoever. 



pid 



timout 



access 



- Process IDentif ication number of the process to 
which a device will be allocated. The pids and 
-1 have special meaning. refers to the calling 
process, -1 refers to the parent of the calling 
process. 

- Should the specified device not be currently 
available, this svc will poll once per second 
until the specified timeout expires. This parameter 
is the number of 1/ 100th second ticks to wait for 

a device to become available. 

- This parameter specifies the intended use for 
the allocated device by the specified process. 
The format of this parameter is the same as the 
mode parameter used by the open and create svcs 
except that bits 2-31 are reserved and should be 



zero. 

bit = read access, 
bit 1 = write access, 
bit 2-31 = reserved. 



l=access desired, 0=no access. 
l=access desired, 0=no access. 
Should be 0. 
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_alloc 



dname 



alcnam 
status 
Diagnostics: 



Address of a null terminated string identifying 

the specific device (or rotor list name) which 

is to be allocated. This string will be translated 

automatically by WMCS into its logical equivalent. 

The string may contain up to 93 significant characters 

followed fcy a null, but must translate to a valid 

device or rotor list name of not more than 27 

characters (16-character nodename with two underscores 

and an 8 character devicename with one underscore and a 

null). 

Address of a 27-character string buffer which will 

contain the null terminated name of the successfully 

allocated device. 

Address of a long word to receive the result of 

the operation. 



errinsufpriv (1) 



erremptyrtrlst 
errnamenull 
errnoname 
errtimeout 

errinvdevnam 

errundevnam 

errnoreadpriv 

errnowritepriv 



(18) 
(80) 
(82) 
(128) 

(130) 

(131) 

(144) 

(145) 



The process lacks the privileges required to 

perform the operation. 

The specified rotor list is empty. 

The specified name must not be null. 

The specified name does not exist. 

The request was not completed within 

the specified time. 

The specified devicename is syntactically 

incorrect. 

The MCS does not recognize the devicename. 

is the device mounted? 

The process does not have Read Privilege for 

the file. 

The process does not have Write Privilege for 

the file. 



See Also: 



_dealloc 

_getalc 

_getrel 

_getrtr 

_setrtr 



Deallocate an allocated device. 
Get names of allocated devices. 
Get names of rotor list elements. 
Get rotor list names. 
Assign device names to a rotor list. 
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_alloc 



Assembler Calling Sequence: 



push 


pid 


push 


timout 


push 


access 


push 


dname 


push 


alcnam 


push 


status 


jsr 


..alloc 



value - process id 

value - time out 

value - access mode 

address - device name 

address - allocated device 

address - result of the operation 

Allocate a device 



C Function Declaration: 



/* Allocate a device */ 
long /* returns result of the operation */ 

_alloc (pid, timout , access , dname , alcnam) 

/* process id */ 

/* time out */ 

/* access mode */ 

/* device name */ 

/* allocated device */ 



long 


pid; 


long 


timout; 


long 


access; 


char 


dname [94] ; 


char 


alcnam[27] 



FORERAN Subroutine Declaration: 



I Allocate a device 
subroutine _alloc (pid, timout , access, dname , alcnam, status) 
integer*4 pid ! process id 
integer*4 timout 1 time out 
integer *4 access 1 access mode 
character *94 dname 1 device name 
character*27 alcnam ! allocated device 
integer*4 status 1 result of the operation 



Pascal Procedure Declaration: 



procedure _alloc( 
pid 
timout 
access 
devnam 
var alcnam 
var status 
) ; external ; 



longint; 
longint; 
longint; 
string [93] ; 
string C26] ; 
longint 



{** Allocate a device) 

{** process id) 

{** time out) 

{** access mode} 

{** device name) 

{** allocated device) 

{** result of the operation) 
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_jallmem 
Allocate dynamic memory. 

Description: 

Allocate a 4K byte page of memory to the calling process, 
or share a 4K byte page of memory with another process. 

For successful page allocation the address of the page must 

be on a 4K byte boundary; it must reside in the first 2 
megabytes of address space (locations $000000 through $1FE000); 
and that address must not have been allocated previously by 
the process receiving the page. Note that for security reasons 
the process cannot allocate memory in the highest page of 
the logical address space, i.e. at location $1FF000. 

Unless the process has writephys privilege, only pages owned 
by the calling process can be shared with another process. 

To share a page, the value of the pid parameter is the process 
id of a process other than the calling process, i.e. the pid of 
the process to receive the page (receiving process). The value 
of the adr parameter specifies the address of a valid page of 
memory within the calling process. The page shared will have 
the same logical address in both the sharing process and the 
receiving process. For successful sharing, the receiving process 
must not have a page of logical memory already allocated at the 
specified address. 

If the value of the pid parameter is zero or the process id 
of the calling process, a new page is allocated to the 
calling process. 

Related Privileges: 

none - Can allocate memory to the current process or can 
share memory with processes with the same owner id 
and group id (uic) 
group - Can share memory with any process with the 

same group id. 
world - Can share memory with any process whatsoever, 
writephys - Can request that an unowned page of memory, assigned 
to the current process be shared with another 
process. 

Parameters: 

pid - Process ID of which process is to receive the 

memory. is used for the current process, -1 for 
the parent of the current process. 
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allmem 



adr - Logical address in the 2 megabyte logical address 
space. Adr must be aligned on 4K byte boundary. 

prot - Protection. indicates no protection; 1 page is 
write protected; other values reserved. 

timout - The wait count is in 100' ths of a second and 

represents the amount of time to wait for a page 
to become available before returning an error. 

status - Address of a long word to receive the result of 
the operation. 



Diagnostics: 

errinsufpriv 

errprcsnotfnd 

errinvadr 

errmemalloc 

errnonowned 

e r rnomeraa va i 1 
errtimeout 

See Also: 



(1) The process lacks the privileges required to 

perform the operation. 

(2) The specified process is not in the system 

process table. 

(4) The logical address, for the memory requested, 
is invalid. 

(5) The process requested a logical page that was 
already allocated. 

(6) The process tried to affect a page in memory it 
did not own. 

(7) All available memory has been allocated. 

(128) A request was not completed within the specif ie 
time. 



__fremera - Deallocate a page of memory 

__getfre - Get amount of available memory 
protmem- Change memory page protection 



Assembler Calling Sequence: 



push 


pid 


push 


adr 


push 


prot 


push 


timout 


push 


status 


jsr 


allmem 



C Function Declaration: 



long 

_allmem (pid, adr, prot, timout) 

long pid; 

long adr; 

long prot; 

long timout; 



;value - process id 

;value - address of new page 

;value - protection 

jvalue - time out 

jaddress - result of the operation 

; allocate dynamic memory 



/* allocate dynamic memory */ 

/* returns result of the operation */ 

/* process id */ 

/* address of new page */ 

/* protection */ 

/* time out */ 
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Fortran Subroutine Declaration: 



Dictionary of MCS System Calls 

allmem 



! allocate dynamic memory 

subroutine allmem(pid, adr, prot, timout, status) 

! process id 

! address of new page 

! protection 

! time out 

! result of the operation 



{** allocate dynamic memory} 

{** process id} 

{** address of new page} 

{** protection} 

{** time out} 

{** result of the operation} 





integer*4 pid 




integer*4 adr 




integer*4 prot 




integer*4 timout 




integer*4 status 


al Procedure Declaration: 


procedure allmem ( 


pid 


: longint; 


adr 


: longint; 


prot 


: longint; 


timout 


: longint; 


var status 


: longint 


) ; external; 
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_ANDEVNT 

Wait for AND of event flags 

Description: 

Suspend process execution until the logical AND of 

one or more event flags is true. When all of the specified 

event flags are simultaneously set (l's) the process 

is resumed. 

Related Privileges : 



none 



group 



world 



Parameters: 



- allows waiting on event flags of any process 
with the same owner id and group id (uic) as the 
calling process. 

- allows waiting on event flags of processes 
with the same group id but a different owner id 
than the calling process. 

- allows waiting on event flags of processes 
whose owner id and group id (uic) are other than 
those of the calling process. 



pid - Process ID of the process whose event flags 

are to be waited on. A indicates the current 

process; -1 indicates the parent of the current 

process, 
efmask - Event flag mask. The mask of all bits which 

must simultaneously be set high for control 

to return to the calling process, 
timout - The wait count in 100 'ths of a second. Represents 

the amount of time to wait for the specified event 

flags to be set before giving up. 

NOTE that time outs are not 
implemented in MCS 4.1. 

status - Address of a long word to receive the result of 
the operation. 

Diagnostics: 

errinsufpriv (1) The process lacks the privileges required to 

perform the operation, 
errprcsnotfnd (2) The specified process is not in the system 

process table, 
errtimeout (128) A request was not completed within the specified 

time. 
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andevnt 



See Also: 



_clrevnt - Clear event flags 
_getevnt - Read event flags 
__orevnt - Wait for OR of event flags 
__setevnt - Set event flags 



Assembler Calling Sequence: 

push pid 

push efmask 

push timout 

push status 

jsr _andevnt 

C function declaration: 



long 

_andevnt (pid, efmask, timout) 

long pid; 

long efmask; 

long timout; 

Fortran Subroutine Declaration: 



;value - process id 

;value - event flag mask 

; value - time out 

jaddress - result of the operation 

;wait for AND of event flags 



/* wait for AND of event flags */ 

/* returns result of the operation */ 



/* process id */ 

/* event flag mask */ 

/* time out */ 



! wait for AND of event flags 
subroutine andevn(pid, efmask, timout, status) 
integer*4 pid ! process id 
integer*4 efmask ! event flag mask 
integer*4 timout ! time out 
integer*4 status ! result of the operation 



Pascal Procedure Declaration: 



procedure andevnt ( 



pid 

efmask 
timout 
var status 
) ; external ; 



longint ; 
longint ; 
longint; 
longint 



{** wait for AND of event flags} 

{** process id} 

{** event flag mask} 

{** time out} 

{** result of the operation} 



ANDEVNT- 2 



_ASSIGN 

Assign a logical name. 

Description: 

Creates, deletes or replaces a logical name in the current process's 
translation table, or in the table of any other process. 

Abbreviations are allowed in logical names. An asterisk (*) 

in the logical name is a marker that indicates the minimum 

string that is a recognized abbreviation of the logical name. 

Abbreviations are recognized only during logical name translation 

( see _trans ) • For example, if the logical name is "PR* INT' , 

a translation of any of the strings "PR", "PRI", "PRItf' , or "PRINT 

will return the equivalence. 

The values of the parameters lname and equiv determine whether 
an entry in the logical name table of the specified process is 
created, removed, or replaced. 

To create a new logical name, the lname parameter must contain 
a logical name which does not match any existing logical names 
in the logical name table of the specified process and the equiv 
parameter must not be null. 

To remove a logical name assignment, the lname parameter must 
contain a logical name which matches a logical name found in 
the logical name table of the specified process and the equiv 
parameter must be null. 

To replace the equivalent string associated with a logical name 
the lname parameter must contain a logical name which matches 
an existing logical name found in the logical name table of the 
specified process and the equiv parameter must not be null. 

If the lname parameter contains a logical name which does 
not match any existing name found in the logical name table 
and the equiv parameter is null, or if the lname parameter 
is null, this system call has no effect. 

If the assignment is made in the current process's translation 
table, it (the assignment) is not in effect after the current 
process terminates. If the assignment is made in another process's 
translation table, it persists for the life of that process. 

Related Privileges: 

none - Allows creation or replacement of a logical name in 
the translation table of any process with the same 
owner id and group id (uic) as the calling process. 
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assign 



group 



world 



- Allows creation or replacement of a logical name in 
the translation table of another process with the same 
group id as the calling process. 

- Allows creation or replacement of a logical name in 
the translation table of any other process. 



Parameters : 



lname 



- Address of null terminated string containing the 
logical name to be added, replaced or deleted from 
the logical name table of the specified process. 
This string may contain up to 93 characters plus a null. 

equiv - Address of null terminated string containing the 
equivalent to which the logical name translates. 
It this parameter contains a null string, the 
logical name represented in parameter lname is 
removed from the logical name table. This string 
may contain up to 93 characters plus a null. 

pid - The process id of the process for which this logical 
name will be in effect. 0=current process, 
-l-parent process. 

status - Address of a long word to receive the result of 

the operation. 



Diagnostics: 

errinsufpriv 

errprcsnotfnd 
ermomemavai 1 



(1) The process lacks the privileges required to 
perform the operation. 

(2) The specified process is not in the system 
process table. 

(7) All available memory has been allocated. 



See Also: 



gassign 
getglb 
getlog 
jengy 

trans 



Assign a global logical name 
Retrieve a global logical name 
Retrieve a logical name 
Get pid of ancestor process 
Translate a logical name 



Assembler Calling Sequence: 



push 


lname 


push 


equiv 


push 


pid 


push 


status 


jsr 


assign 



C function declaration: 



jaddress - logical name 

jaddress - translation string 

;value - process id 

jaddress - result of the operation 

jassign a logical name 



/* assign a logical name */ 
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assign 



long 

_assign (lname, equiv, pid) 

char lname [94] ; 

char equiv [94] ; 

long pid; 

Fortran Subroutine Declaration: 



/* returns result of the operation */ 

/* logical name */ 

/* translation string */ 

/* process id */ 



! assign a logical name 
subroutine assign( lname, equiv, pid, status) 



character*94 lname 
character*94 equiv 
integer*4 pid 
integer*4 status 

Pascal Procedure Declaration: 



logical name 
translation string 
process id 
result of the operation 



procedure _assign( 

lname 

equiv 

pid 
var status 
) ; external; 



string[93]; 
string[93]; 
longint ; 
longint 



{** assign a logical name} 

{** logical name} 

{** translation string} 

{** process id} 

{** result of the operation} 



ASSIGN-3 



_CHDIR 
Set default device and directory. 
Description: 

Used by a process to change its default directory. 

Any subsequent file references that do not have an explicit 
path name will be assumed to be in this directory. In 
essence, the named path becomes the current working directory. 

Unless the process has bypass privilege, it must have read 
privilege to the new default device, execute privilege to 
all directories up to the new default directory and read 
privilege to the default directory. 

If the devdir is specified in fcb.seq number format, the process 
must have read privilege to the new default device and read 
privilege to the new default directory. 

Related Privileges: 



None 
altuic 

bypass 

system 

Parameters: 



- Successful if process has access to the device and 
directories as described above. 

- Successful if the owner of image file for the 
current process has access to the device and directory 
as described above. 

- Allows the process to set the default to any 

mounted device and directory independent of the 
file protection. 

- Successful if the system has access to the device 
and directory as described above. 



devdir - Address of a null terminated string which contains 
the new default device and directory specification. 
This string will be translated automatically by the 
MCS to its logical equivalence. This parameter may 
have up to 93 characters (the null makes 94) 

status - Address of a long word to receive the result of 
the operation. 



Diagnostics: 

er rnomema vai 1 
errinvdevnam 

errundevnam 



(7) All available memory has been allocated. 

(130) The specified devicename is syntactically 
incorrect. 

(131) The MCS does not recognize the devicename. 
Is the device mounted? 

errnoexecpriv (143) The process does not have Execute Privilege 



CHDIR-1 



Dictionary of MCS System Calls 
chdir 



for the file, 
errnoreadpriv (144) The process does not have Read Privilege for 

the file. 

(148) The specified directory is not a directory. 

(149) The specified directory name is syntactically 
incorrect. 

(173) The device class is inappropriate for the 
operation. 

(174) Directories do not exist on the specified 
device. 

(177) The specified directory does not exist. 

(178) The file's FCB.SEQ number in the directory 
file is incorrect. 
Device integrity errors. 



errinvdirf le 
errinvdirstr 

errinvcloper 
errinvdirdev 

errdimotfnd 
errinvseqnum 



See Also: 



_create - Create a file 

delete - Delete a file 

"getdir - Get default device and directory 
open - Open a file 
rename - Rename a file 
setfprt- Set file protection 



Assembler Calling Sequence: 



push 


devdir 


push 


status 


jsr 


chdir 



C function declaration: 



long 

__chdir( devdir) 

char devdir [94] ; 

Fortran Subroutine Declaration: 



jaddress - new device/directory 
jaddress - result of the operation 
;set default device and directory 



/* set default device and directory */ 
/* returns result of the operation */ 

/* new device/directory */ 



! set default device and directory 

subroutine chdir(devdir , status) 

character*94 devdir ! new device/directory 

! result of the operation 



integer*4 status 
Pascal Procedure Declaration: 

procedure __chdir( 

devdir : string[93]; 
var status : longint 
) ; external; 



{** set default device and directory} 
{** new device/directory} 
{*"*" -esult of the operation} 
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_CHSUPER 

Change to supervisor mode. 

Description: 

Sets the supervisor bit (bit 13) in the CPU status register. 
Allows execution of privileged instructions. 

If the call is successful, the system returns control to the 

process with the CPU in supervisor mode. The process will 

continue in supervisor mode until the process changes the 
status register back to user mode. 

Note especially that with the change to supervisor mode comes 
a transition to using the supervisor stack pointer. The 
supervisor stack is approximately 1700 bytes in length 
and is located in system memory. Overflowing the system stack 
will crash the process and probably the system also. 

Data that was on the users stack prior to this call will have 
to be accessed differently while in supervisor mode. 

Note that with the processor in supervisor mode, the 
user has complete access to all hardware features of the 
system. Indiscriminate memory accesses may lead to unexpected 
and disastrous results. 

Related Privileges: 

none - Process not allowed to change to supervisor mode 
chngsuper - Allows process to change to supervisor mode 

Parameters: 

status - Address of a long word to receive the result 
of the operation. 

Diagnostics: 

errinsufpriv (1) The process lacks the privileges required to 

perform the operation. 

See Also: 

chuser - Change processor mode to user 

Assembler Calling Sequence: 

push status ;address - result of the operation 

jsr chsuper ; change to supervisor mode 
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C function declaration: 

/* change to supervisor mode */ 
long /* returns result of the operation */ 

_chsuper() 

Fortran Subroutine Declaration: 

c ! change to supervisor mode 

subroutine chsupe( status) 

integer*4 status ! result of the operation 

Pascal Procedure Declaration: 

procedure chsuper( {** change to supervisor mode} 

var status : longint {** result of the operation} 
) ; external; 
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_CHUSER 

Change processor mode to user. 

Description: 

Clears the supervisor bit (bit 13) in the CPU status register. 
Provides high level languages the ability to convert back to 
user mode from supervisor mode. 

Note that with the change to user mode comes a transition 
to using the user stack pointer. 

Note that unless the process is currently in supervisor 
mode a fatal error will occur when an attempt is made to 
write to the status register. 

Related Privileges: 

None. 
Parameters : 

None. 

Diagnostics: 

None . 
See Also: 

_chsuper - Change to supervisor mode 
Assembler Calling Sequence: 

jsr chuser ;change processor mode to user 

C function declaration: 

/* change processor mode to user */ 
void /* no result */ 

_chuser() 

Fortran Subroutine Declaration: 

c ! change processor mode to user 

subroutine chuser 

Pascal Procedure Declaration: 

procedure chuser; {** change processor mode to user} 
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external ; 
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_CLONE 
Create a new process by cloning an existing process 

Description: 

This call is similar to _crproc except that rather than load the 
image for the process to be created from some mass storage media 
specified by a file name, the process is created via copying 
(cloning) an already existing process specified by a PID. 

Each process under control of the operating system must be created by 
a call to this operating system service routine or to _crprcc, 
_crprcs r or _mulcrps. When a process is created, it is called a 
child process. The process that created it is called its parent 
process. 

SPAWN and PORK are two different modes of creation. Spawned processes 
run in series. This means that the parent process hibernates while 
the child process runs. When the child process terminates , the 
parent process resumes. Hie completion status of the child is 
returned to the parent. 

Forked processes run in parallel. The parent process is not 
hibernated, but continues execution immediately after successful 
creation of the child process. 

The calling process must be able to access the process specified by 
the PID either via group privilege, world privilege, or the 
protection allowing public access to it for successful creation of 
the cloned process. 

Without the setpriv privilege, the child may not be given more 
privileges than the parent has. 

The child process is created with the same default device and 
directory as the parent. 

Related Privileges: 

none - Allows the parent process to create a child 

from an existing process to which the parent has 

only public access. The child may not 

be given privileges not possessed by the parent. 
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group 



setpriv 

setprior 

world 



Parameters: 
mode 

pid 

pname 



priv 



Allows the parent process to create a child 
process with the same group ID but a different 
owner ID than the parent process has. Also 
allows the cloning of processes with the same 
group ID but a different owner ID that the 
creating process has. 

Allows the parent process to give the child 
process more privileges than those possessed 
by the parent. 

Allows the parent process to initiate a child 
at a higher priority level and/or with a higher 
timeslice than the parent. 
Allows the parent process to create a child 
with any owner ID and group ID (UIC) whatsoever. 
Also allows a process to clone a process with 
any owner ID and group ID (UIC) whatsoever. 



Whether the process is spawned or forked. 
A indicates spawn, 1 indicates fork. All other 
values are reserved and should not be used. 
The process ID of the process to be cloned. 
Hie new process will be created on the same site 
where the process being cloned exists. 
Address of a 17 byte null terminated string 
containing the process name to be given the 
new process. This string is used for human 
identification. (16 significant characters 
plus a null) 

The privilege mask contains a bit mask of 
privileges to be given to the child process. 
A -1 indicates that the child should receive 
the same privileges that the parent has. 
Privileges are bit encoded as follows: 



Bit Name Bit # 


Description 


pcbpvsetpriv 





setpriv 


pcbpvsystem 


1 


system 


pcbpvreadphys 


2 


readphys 


pcbpvwritephys 


3 


writephys 


pcbpvsetprior 


4 


setprior 


pcbpvchngsuper 


5 


chngsuper 


pcbpvbypass 


6 


bypass 


pcbpvoperator 


7 


operator 


pcbpvaltuic 


8 


altuic 


pcbpvworld 


9 


world 


pcbpvgroup 


10 


group 
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priort 



tslice 



uic 



sysin 



sysout 



syserr 



cmd 



pcbpvnetwork 
pcbpvsetattr 



11 network 

12 setattr 

13-31 Reserved. Must be set to zero. 
The priority level (0..15) at which the child process 
will execute. Level is the highest priority. 
A minus one (-1) in this parameter means to use the 
same priority as the parent process. 
The timeslice value. The maximum amount of time the 
child process will be able to run each time it is 
scheduled. This time is specified in .01 milliseconds. 
(A timeslice of 100 represents 1 millisecond) 
A minus one (-1) in this parameter means to use the 
same timeslice as the parent process. 
The user identification code of the child process. The 
most significant 16 bits represent the owner ID and the 
least significant 16 bits represent the group ID. 
A minus one (-1) in this parameter means to use the 
same UIC as the parent process. 

Address of a 94 byte null terminated string containing 
the name of the standard input file for the 
child process. This string will be translated automatically 
by the WMCS to its logical equivalent. The equivalent 
string will be assigned the logical name "SYSSINHJT" in 
the logical name table of the child process. The string 
passed is NOT checked for validity. It may contain up 
to 93 significant characters followed by a null. 
Address of a 94 byte null terminated string containing 
the name of the standard output file for the 
child process. This string will be translated 
automatically by the WMCS to its logical equivalent. 
The equivalent string will be assigned the logical name 
"SYS$OUTPUT" in the logical name table of the child 
process. The string passed is NOT checked for validity. 
It may contain up to 93 significant characters followed 
by a null. 

Address of a 94 byte null terminated string containing 
the name of the standard error file for the 
child process. This string will be translated automatically 
by the WMCS to its logical equivalent. The equivalent 
string will be assigned the logical name "SYS$ERROR" in 
the logical name table of the child process. The string 
passed is NOT checked for validity. It may contain up 
to 93 significant characters followed by a null. 
Address of the command line, (up to 3072 bytes) 
The command line may contain any data whatever 
to be passed from the parent to the child. 
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cradlen 
chpid 



ccode 



The data appears on the top of the child process's 
stack as the child process begins. The long word 
at the top of the child's stack is the length in 
bytes of the command line. At the location (USPf4) 
on the child's stack is a long word which contains 
the starting address of the command line. 

- Length of the command line specified in bytes. 

- Address of a long word to receive the PID of the child 
process. Note that this is only valuable in the case 
that the child is forked. If the address of the long 
word is zero, no value is returned. 

- Address of a long word to receive the completion code 
returned to the parent ty the process responsible for 
terminating the child process. If the child is exited 
as a result of a system violation (memory violation/ 
illegal instruction , ...) the system supplies the ccode. 
If the process terminates normally, the process itself 
supplies the ccode. If the process is exited by another 
process, the other process supplies the ccode. Note 
that the ccode will always be zero for processes that 
are forked. If the address of the long word is zero, 

no value is returned. Completion codes that may be 

supplied by the system include: 

erralarmexit (28) The system clock reached the value 

specified for _JVLARM. 
The process has an undefined trap: 

Divide-by-zero . 
The process has an undefined trap: 

CHK Instruction. 
The process has an undefined trap: 

TRAW Instruction. 
The process has an undefined trap: 

■TOACE. 
The process has an undefined trap: 

1010 Instruction. 
The process has an undefined trap: 

1111 Instruction. 
The process attempted to execute a 

privileged instruction. 
The process attempted to execute an 

illegal instruction. 
The process has a bus error. 
The process has an address error. 
The process attempted to access 

nonexistent memory. 
The process has a memory parity-error. 



errzerodivtrap (29) 



errchktrap 



(30) 



errtrapvtrap (31) 
errtracetrap (32) 



errlOlOtrap 


(33) 


errlllltrap 


(34) 


errprivintrap 


(35) 


errillintrap 


(36) 


errbustrap 
erradrtrap 
errnonexmem 


(37) 
(38) 
(39) 


errmemparity 


(40) 
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errwriteprot 
errundeftrap 
errundefsvc 



(41) 



status 



Diagnostics : 



The process attempted to write to a 
write-protected page in memory. 
__3EPERP was not used to define a call 

for a trap other than TRAP 0. 
The MCS does not recognize the SVC 
number used by the process. 
[CTRL] c terminated the process. 
- Address of a long word to receive the result of 
the operation. 



(42) 



(43) 



errcontccode (255) 



errinsufpriv (1) 

errnomemavail (7) 

errinvsiteid (8) 

errnotimfle (21) 

er r imagetmbad ( 53 ) 

errinvdevnam (130) 

errundevnam (131) 

errfilnotfnd (133) 

errreadleof (140) 

errnoexecpriv (143) 

errnoreadpriv (144) 

errinvfnstr (147) 

errinvdirfle (148) 

errinvdirstr (149) 

errdirnotfnd (177) 

errfilopen (202) 



The process lacks the privileges required to 

perform the operation. 

All available memory has been allocated. 

The specified site ID does not exist. 

The specified file is not an image file. 

(MCS error) The bitmap changed during the 

creation of the process. 

The specified devicename is syntactically 

incorrect. 

The MCS does not recognize the devicename. 

Is the device mounted? 

The specified file could not be found. 

The process tried to read past the logical end 

of a file. 

The process does not have Execute Privilege 

for the file. 

The process does not have Read Privilege for 

the file. 

"Hie specified filename is syntactically incorrect. 

The specified directory is not a directory. 

The specified directory name is syntactically 

incorrect. 

The specified directory does not exist. 

The process tried to simultaneously open more 

than one tape file. 



See Also: 



__crprcs 

_crproc 

_exproc 

_mulcrps 

_setpnam 

.jsetpri 

_settmsl 

_setuic 



Simplified create process 
Create a new process 
Terminate the specified process 
Multiple create process 
Change process name 
Change priority level 
Change scheduling timeslice 
Set process UIC 
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Assembler Calling Sequence: 



push 


mode 


push 


pid 


push 


pname 


push 


priv 


push 


prior t 


push 


tslice 


push 


uic 


push 


sysin 


push 


sysout 


push 


syserr 


push 


cmd 


push 


cmdlen 


push 


pid 


push 


ccode 


push 


status 


jsr 


_clone 



; value - spawn or fork 

;value - pid of process to clone 

; address - process name 

;value - process privilege 

; value - process priority 

; value - process timeslice 

;value - user identification code 

;address - standard input file 

; address - standard output file 

;address - standard error file 

; address - command line 

;value - length of cmd 

; address - childs pid 

; address - childs completion code 

;address - result of the operation 

; clone an existing process 



C Function Declaration: 



long 
_clone(mode, pid, 



/* clone an existing process */ 
/* returns result of the operation */ 
pname , priv, priort, tslice, uic, 

sysin, sysout/ syserr, cmd, cmdlen, chpid, ccode) 



long mode; 
long pid; 
char pname [17] ; 
long priv; 
long priort; 
long tslice; 
long uic; 
char sysin [94] ; 
char sysout [94] ; 
char syserr [94] ; 
char cmd[3072]; 
long cmdlen; 
long *chpid; 
long *ccode; 



/* spawn or fork */ 

/* PID of process to clone */ 

/* process name */ 

/* process privilege */ 

/* process priority */ 

/* process timeslice */ 

/* user identification code */ 

/* standard input file */ 

/* standard output file */ 

/* standard error f ile */ 

/* command line */ 

/* length of cmd */ 

/* childs pid */ 

/* childs completion code */ 
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FORERAN Subroutine Declaration: 

c I clone an existing process 

subroutine _clone(mode, pid f pname, priv f priort, 



tslice f uic, sysin, sysout, syserr, and, 
cmdlen, chpid, ccode, status) 



integer *4 mode 
integer *4 pid 
character*17 pname 
integer *4 priv 
integer *4 prior t 
integer *4 tslice 
integer *4 uic 
character *94 sysin 
character*94 sysout 
character*94 syserr 
character* (*) and 
integer *4 cmdlen 
integer *4 chpid 
integer*4 ccode 
integer*4 status 



Pascal Procedure Declaration: 



procedure _clone( 


' r 


mode : 


longint; { 


pid : 


longint; 


pname 


! string [16] ; { 


priv : 


longint; { 


priort j 


: longint; { 


tslice ; 


: longint; { 


uic j 


: longint; { 


sysin ! 


: string [93]; { 


sysout ! 


: string[93]; { 


syserr 


: string[93]; { 


cmd 


: *array__ofLchar; 


cmdlen 


: longint; { 


var chpid 


: longint; { 


var ccode 


: longint; { 


var status 


: longint { 


) ; external ; 





execution mode (spawn or fork) 

PID of process to clone 

process name 

process privilege 

process priority 

process timeslice 

user identification code 

standard input file 

standard output file 

standard error file 

command line 

length of cmd 

childs pid 

childs completion code 

result of the operation 



** clone an existing process } 
** spawn or fork} 

'** process name) 

.** process privilege) 

.** process priority} 

;** process timeslice} 

[** user identification code} 

.** standard input file} 

[** standard output file} 

■** standard error file} 

{** command line} 
!** length of cmd} 
!** childs pid} 
!** childs completion code} 
:** result of the operation} 
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Close a file. 

Description: 

Given a valid logical unit number (lun) , close a file. That is, make 
the file inaccessible to the current process through that lun. If the 
flush flag is set on a disk device, all disk cache buffers will be 
written to the device. If the device is a tape, the tape buffer is 
written to the device. 

Any pending errors encountered during asynchronous reads to this file 
will be returned as warnings to the _close. 

If the delete option is specified in the mode parameter, the process 
must have read and write privilege to the device containing the file, 
read and write privilege to the directory containing the file, and 
delete privilege to the file itself in order for the file to be 
successfully deleted. 

Related Privileges: 

none - The file will be closed. Allows optional deletion of the 
file if the process has privileges to the file as 
described above. Returns a warning if the process 
specified delete upon closing and does not have privilege 
to the file as described above. 

bypass - Allows the process to delete the file upon closing, 
independent of the process's privilege to the file. 

system - Allows the process to delete the file upon closing if the 
system has privilege to the file as described above. 

Parameters: 



lun 
mode 



Logical unit number. 

Bit encoded long word specifying action to be taken upon 
closing. If the bit is a zero, no action is performed. 
The following descriptions apply when the specified bit 
is set (1) : 
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Bit Name 



Bit # Description 



cldelete 



clnotruncfile 1 



clnodelete 



clforceowrite 3 



clsupalldelete 4 



clzerodelete 



status 



6-31 
Address of a long word 
the operation. 



Delete - Requests that the file be 
deleted upon closing. If other 
processes have the file open, the 
file will be marked for deletion, 
no error is returned, and as soon 
as the file is closed by all 
processes it will be deleted. 
No truncate - Specifies that when 
the disk file is closed, the 
extra physical sectors allocated 
to the file are not to be released. 
For tape devices, this bit 
specifies that the last block 
written to the tape should be 
written as a full sized block (as 
opposed to a variable sized block) . 
No delete - Overrides the delete 
upon closing request specified by 
the _open system call. 
Forced write - Writes to the 
device all data in system buffers 
associated with this lun. If an 
error occurs it will be reported 
as a warning to the calling 
process. The file is always 
closed. 

Suppress all deletes - Overrides 
all deletes that have been set for 
the file, i.e., opdelete or a 
delete set by a different process. 
Zero delete - Zero each sector of 
the file before deleting the file. 
This bit is only valid if the file 
is being deleted (via cldelete or 
some other way) . 
Reserved. Must be set to zero, 
to receive the result of 



Diagnostics : 
errinvlfn 
errnodelpriv 



(132) The logical unit number does not correspond 

to an open file. 
(146) The process does not have Delete Privilege for 

the file. 
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erropendel (153) The specified file is open, has been marked for 

deletion, 
errdelfile (158) System files cannot be deleted, 
errdevwrtprot (269) TRie specified device is write-protected. 



See Also: 



..create - Create a file 

..delete - Delete a file 

_f rdwait - Wait for a fast read to complete 

_open - Open a file 



Assembler Calling Sequence: 



push 


lun 


push 


mode 


push 


status 


jsr 


_close 



C Function Declaration: 



long 
_close 



dun, mode) 
long lun; 
long mode; 



;value - logical unit number 
; value - mode word 
; address - result of the operation 
; close a file 



/* close a file */ 

/* returns result of the operation */ 



/* logical unit number */ 
/* mode word */ 



Fortran Subroutine Declaration: 



! close a file 
subroutine _close (lun, mode, status) 



integer *4 lun 
integer*4 mode 
integer*4 status 

Pascal Procedure Declaration: 

procedure _close( 

lun : longint; 
mode : longint; 
var status : longint 
) ; external ; 



I logical unit number 

I mode word 

I result of the operation 



{** close a file) 
{** logical unit number} 
{** type of access requested} 
{** result of the operation} 
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Clear event flags. 

Description: 

Clears the specified event flags of a particular 
process. 

Related Privileges: 



None 

group 
world 

Parameters: 



- Allows clearing event flags of any process 

with the same owner id and group id as the calling 
process. 

- Allows clearing the event flags of any process 
with the same group id as the calling process. 

- Allows clearing the event flags of any process 
whatever. 



pid - Process ID of the process whose event flags 

are to be cleared. refers to current process; 

-1 references the parent of the current process, 
efmask - Event flag mask. The 32 bit mask of those flags which 

are to be cleared. Bits set within the mask correspond 

to the event flags which will be cleared, 
status - Address of a long word to receive the result of 

the operation. 



Diagnostics: 

errinsufpriv 
errprcsnotfnd 

See Also: 



(1) The process lacks the privileges required to 
perform the operation. 

(2) The specified process is not in the system 
process table. 



__andevnt - Wait for AND of event flags 

__getevnt - Read event flags 

_orevnt - Wait for OR of event flags 

setevnt - Set event flags 



Assembler Calling Sequence: 



push 


pid 


push 


efmask 


push 


status 


jsr 


clrevnt 



;value - process id 
;value - event flag mask 
jaddress - result of the operation 
; clear event flags 
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C function declaration: 



long 

_clrevnt (pid, efmask) 

long pid; 
long efmask; 

Fortran Subroutine Declaration: 



/* clear event flags */ 

/* returns result of the operation */ 

/* process id */ 

/* event flag mask */ 



! clear event flags 

subroutine clrevn(pid, efmask, status) 
integer*4 pid ! process id 
integer*4 efmask ! event flag mask 
integer*4 status ! result of the operation 



Pascal Procedure Declaration: 

procedure __clrevnt( 

pid : longint; 
efmask : longint; 
var status : longint 

) ; external; 



{** clear event flags} 

{** process id} 

{** event flag mask} 

{** result of the operation} 
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Make a connection to a remote machine. 

Description: 

This system call is used to establish a logical connection with a 
remote machine. It does this by allocating a network link (virtual 
circuit) to the process for use in network communication. 

There must be an entry in the remote machine's NETUAF.DAT file 



matching the UIC of 
_connect to succeed. 



the process requesting the connection for the 



This SVC does* not need to be called prior to accessing other nodes on 
a network. All SVCs that access other nodes in the network will 
automatically issue a connect request if the process does not already 
have an open connection to the node. Use this SVC if you want to 
ensure that you have a good connection to another node prior to 
performing any operations on that node. This may simplify error 
reporting. 

Related Privileges: 



none 
network 

Parameters: 



- Process not allowed to access the network. 

- Process allowed to perform network operations. 



siteid - Site ID of the system with which a connection is 

being attempted, 
status - Address of a long word to receive the result of 

the operation. 



Diagnostics : 

errinsufpriv 

errnomemavail 

errinvsiteid 

errremotelogon 

errnoclass 



(1) The process lacks the privileges required to 
perform the operation. 

(7) All available memory has been allocated. 

(8) The specified site ID does not exist. 

(47) The process was not allowed to logon to the 

remote system 
(185) The device class handler was not loaded when 

the system was booted. 
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See Also: 



_disconn - Break a remote connection 
_dconall - Break all remote connections 
_dconidle - Break all idle remote connections 



Assembler Calling Sequence: 



push 
push 
jsr 



siteid 
status 
_connect 



;value - site being connected to 
; address - result of the operation 
;make a remote connection 



C Function Declaration: 



long 

_connect( siteid) ; 

long siteid; 

FORTRAN Subroutine Declaration: 



/* make a remote connection */ 

/* returns result of the operation */ 

/* site being connected to */ 



! make a remote connection 
subroutine _connec (siteid, status) 

integer*4 siteid 1 site being connected to 
integer*4 status ! result of the operation 



Pascal Procedure Declaration: 

procedure _connect( 

siteid : longint; 
var status : longint 
) ; external ; 



{** make a remote connection } 
{** site being connected to } 
{** result of the operation } 
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Create a file. 

Description: 

After logical name translation, the specified file is created. Upon 
successful completion of the create, the file is opened and the 
logical unit number is returned. If a specific version number is 
requested, the file is created provided that there is no file with 
the specified filename and version number. If the version number is 
or no version number is specified, the new file will be assigned a 
version number one higher than the previous highest version number on 
a file with the same name in the specified directory. 

Iftiless the process has bypass privilege, it must have read and write 
privilege to the device to contain the file, execute privilege to the 
device to contain the file, execute privilege for all directories in 
the path leading to the file, and read and write privilege to the 
directory to contain the file for the file to be successfully 
created. 

If the delete upon closing option is specified in the mode parameter, 
the process must have read and write privilege to the device 
containing the file, read and write privilege to the directory 
containing the file, and delete privilege to the file itself for the 
file to be successfully deleted. 

Related Privileges: 

none - Allows creation only if process has access as described 

above. Ihe created file may not have a UIC other than 

that of the calling process, 
altuic - Allows creation if the owner of the image file for the 

current process has access as described above, 
bypass - Allows the process to create the file independent of the 

file protection, 
group - Allows the process to create a tile with the same group 

ID but a different owner ID than the calling process, 
system - Allows creation if the system has access as described 

above, 
world - Allows the process to create a tile with any UIC. 



CREATE-1 



Dictionary of WMCS System Calls 
_create 



Parameters: 
fname 



mode 



Address of a null terminated string containing the 
name of the file to be created. The string will be 
translated automatically by WMCS to its logical 
equivalence. This string may contain up to 93 
significant characters followed by a null. 
Bit encoded long word specifying the type of access 
required. Hie following description explains the 
options when the specified bit is set (1) . 
Bit Name Bit # Description 



Read access - Requests permission 
to read the file. 

Write access - Requests permission 
to write the file. 
Read lock - Requests permission 
for exclusive read access to the 
file. 

Write lock - Requests permission 
for exclusive write access to the 
file. 

Delete - Requests that the file be 
deleted upon closing. 
Append - Specifies that the 
initial file position be at the 
logical end of file. 
Fast read - Specifies that the 
file will be read asynchronously. 
That is r that control returns to 
the user process before the data 
have actually been read. As 
records are read, they will be 
transferred directly into the 
process's logical address space 
bypassing the device cache. Tliis 
bit is only valid for disk class 
devices. Other requirements are 
1) Supports only requests for 
complete sectors only, 2) Process 
buffer must be on a word boundary, 
3) Request cannot cross a 4 Kbyte 
page boundary. Use the _frowait 
system call to determine when 
asynchronous reads are complete. 
Open next file - On a tape device, 
specifies to open the "next" file 
without regard to the filename. 



opreadacc 





cpwriteacc 


1 


opreadlock 


2 


opwritelock 


3 


opdelete 


4 


opappend 


5 



opfastread 



opnextfile 
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_create 



reel en 



opnordahead 8 No read ahead - Specif ies that 

read ahead is not to be done on 
the opened file, 
opnotruncf ile 9 No truncate - Specifies that when 

the file is closed the extra 
physical sectors allocated to the 
file are not to be released, 
cropenifthere 10 Open if there - Specifies that the 

file will be opened if it exists. 
Only if it does not exist will it 
be created. If the file does exist 
and this bit is set the ftype, 
prot. , uic, fid, mstime, and lstime 
parameters are ignored. The reel en 
parameter will specify the record 
length for this open and does not 
alter the default record length 
associated with the file, 
cropenshared 11 Open shared - Specifies that if 

the current process or any 
ancestor of the current process 
has a file with the specified 
name (fname) and with the same 
access modes currently open, 
this process will share the file 
with the ancestor, including the 
default file position. As the file 
is read or written, the default 
position is adjusted for both the 
current process and the ancestor, 
opzerodelete 12 Zero delete - Zero each sector of 

the file before deleting the file, 
ttiis bit is only valid if the file 
is being deleted (via cldelete or 
some other way) . 
13-31 Reserved. Must be set to zeros. 
Default file record length in bytes. Must be between 
and 65535. In the case of the "open if there" mode and 
the file exists, this parameter overrides the default 
record length specified for the file. If a zero or 
$FFFFFFFF (-D i s used, the file will be created with a 
record length of 1. In the case that the named file 
exists and the "open if there" bit is set, a $FFFFFFFF 
(-1) signifies that the default length of the specified 
file is to be used. 
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ftype - A numerically valued field specifying the file type. 
File Type Value Description 



fcbftdata 





data 


fcbftdir 

fcbftimage 

fcbftksamdata 


1 
2 
3 


directory 
image file 
KSAM data file 


fcbftksamkey 
fcbftllimage 
fcbftarchcont 


4 
5 
6 


KSAM key file 
LL image file 
archive file continuation 




7 


reserved 


fcbftsystem 
fcbftarchive 


8 
9 


system file 
archive file 




20-255 


reserved 



256-65535 user defined 
prot - File protection mask. The least significant 16 bit 
word of this parameter is divided into 4 nibbles. 
Each nibble corresponds to a class of users. The bits 
within each nibble represent the type of access that 
class of user is granted for this file. If the bit is 
set (1) , the access is granted. 

From the least to the most significant nibble the user 
classes are: 

(Xttir - file owner 

Grp - processes with the same group ID as the owner 

Pub - all other processes in the system 

Sys - processes with SYSTEM privilege. 

Sys Pub Grp Qvnr 

IDWREIDWREIDWREIDWREI 

I 1 

MSB L£B 

From the least to the most significant bits within the 
nibbles, the access privileges are: 

E - Execute access 

R - Read access 

W - Write access 

D - Delete access 

The value $FFFFFFFF (-1) is a reserved value that means 
that the user's default protection mask is to be used. 
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_create 



uic 



fid 
mstime 



lstime 



lun 
status 

Diagnostics : 



- The user identification code, specifying the owner of the 
file. The roost significant 16 bits of this parameter 
contain the owner ID, and the least significant 16 bits 
contain the group ID. A value of $FFFFFFFP (-1) is a 
reserved value which means to give the file the same UIC 
as the calling process. 

- The least significant 16 bits of this parameter become 
the file identification code to be associated with the 
file. 

- The most significant 32 bits of the file creation date 
and time in system time format. This parameter may be 
used to specify a file creation date other than the 
current date. If the value of this parameter is $FFFFFFFF 
(-1) , the current date (year and day) will be used. 
Otherwise , the value specified will be used for the 
creation date. This value is not checked for validity. 

- The least significant 32 bits of the file creation date 
and time in system time format. This parameter may be 
used to specify a file creation time other than the 
current time. If the value of this parameter is $FFFFFFFF 
(-1) , the current time (hour, minute, second and tick) 
will be used. Otherwise, the value specified will be 
used for the creation time. This value is not checked 
for validity. 

- Address of a long word to receive the logical unit number 
of the open file. 

- Address of a long word to receive the result of 
the operation. 



errinsufpriv (1) 

errnomemavail (7) 

errinwernum (129) 

errinvdevnam (130) 

errundevnam (131) 

errfilexists (134) 

errinvreclen (138) 

errinvfiletype (139) 

er rnoexecpr iv ( 143 ) 



The process lacks the privileges required to 

perform the operation. 

All available memory has been allocated. 

A file's version number cannot be greater than 

65535. 

The specified devicename is syntactically 

incorrect. 

The MCS does not recognize the devicename. 

Is the device mounted? 

The specified version of the file already 

exists. 

Edit mode 3 requires that the file's record 

length be set to one. 

The specified file type is reserved for the MCS. 

Hhe process does not have Execute Privilege 

for the file. 
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errnoreadpriv 


(144) 


errnowritepriv 


(145) 


errnodelpriv 


(146) 


errinvfhstr 


(147) 


errinvdirfle 
errinvdirstr 


(148) 
(149) 


errinvcloper 


(173) 


errdirnotfnd 
errdirinwer 


(177) 
(200) 


errfilopen 


(202) 


See Also: 




_close - Close a f 
_creats - Simplifie 



The process does not have Read Privilege for 

the file. 

The process does not have Write Privilege for 

the file. 

The process does not have Delete Privilege for 

the file. 

The specified filename is syntactically 

incorrect. 

The specified directory is not a directory. 

The specified directory name is syntactically 

incorrect. 

The device class is inappropriate for the 

operation. 

The specified directory does not exist. 

A directory file cannot have a version number 

greater than one. 

The process tried to simultaneously open more 

than one tape file. 



file 

Led file creation 
_defprot - Set default protection mask 
_delete - Delete a file 
_open - Open a file 
.jsetfprt - Set file protection 



Assembler Calling Sequence: 



push 


fname 


push 


mode 


push 


reel en 


push 


ftype 


push 


prot 


push 


uic 


push 


fid 


push 


mstime 


push 


lstime 


push 


lun 


push 


status 


jsr 


_create 



; address - file name 

; value - type of access requested 

;value - record length 

;value - file type 

;value - protection 

;value - user identification code 

;value - file ID 

; value - day and year 

; value - hour, minute , second, tick 

; address - logical unit number 

; address - result of the operation 

;create a file 
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_create 



/* create a file */ 

/* returns result of the operation */ 

ftype, prot, uic, fid, mstime, 

lun) 
/* file name */ 
/* type of access requested */ 
/* record length */ 
/* file type */ 
/* protection */ 
/* user identification code */ 
/* file ID */ 
/* day and year */ 
/* hour, minute, second, tick */ 
/* logical unit number */ 

PORIKAN Subroutine Declaration: 

c 1 create a file 

subroutine _create (fname, mode, reclen, ftype, prot, 
& uic, fid, mstime, lstime, lun, status) 
character *94 fname 1 file name 
integer*4 mode ! type of access requested 
integer*4 reclen 1 record length 



long 




_create 


(fname, mode, reclen, 




lstime, 




char fname [94] ; 




long mode; 




long reclen; 




long ftype; 




long prot; 




long uic; 




long fid; 




long mstime; 




long lstime; 




long *lun; 



integer*4 ftype 
integer *4 prot 
integer *4 uic 
integer*4 fid 
integer *4 mstime 
integer*4 lstime 
integer *4 lun 

Pascal Procedure Declaration: 

procedure _create( 



fname : 


string [933 ; 


mode : 


longint; 


reclen ; 


' longint; 


ftype ; 


: longint; 


prot : 


: longint; 


uic 2 


• longint; 


fid j 


: longint; 


mstime 


: longint; 


lstime 


: longint; 


var lun 


: longint; 


var status 


: longint 


) ; external ; 





! file type 

I protection 

! user identification code 

I file ID 

I day and year 

I hour, minute, second, tick 

! logical unit number 



{** create a file) 

{** file name) 

{** type of access requested) 

{** record length) 

{** file type) 

{** protection) 

{** user identification code) 

{** file 3D) 

{** day and year) 

{** hour, minute, second, tick) 

{** logical unit number) 

{** result of the operation) 
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Simplified file creation. 

Description: 

This system call is simplified form of ..create. Default values are 
assumed for the file type (data file) , the file protection (uses the 
user ' s default protection mask) , the uic (becomes the same as that of 
the calling process) , fid (uses 0) , creation date and time (uses the 
current date and time) . 

After logical name translation, the specified file is created. Upon 
successful completion of the create, the file is opened and the 
logical unit number is returned. If a specific version number is 
requested, the file is created provided that there is no file with 
the specified file name and version number. If version number 0, or 
no version number is specified, the new file will be assigned a 
version number one higher than the previous highest version number on 
a file with the same name in the specified directory. 

Unless the process has bypass privilege, it must have read and write 
privilege to the device to contain the file, execute privilege for 
all directories in the path leading to the file, and read and write 
privilege to the directory to contain the file for the file to be 
successfully created. 

If the delete upon closing option is specified in the mode parameter, 
the process must have read and write privilege to the device 
containing the file, read and write privilege to the directory 
containing the file and delete privilege to the file itself for the 
file to be successfully deleted. 

Related Privileges: 

none - Allows creation only if process has access 

as described above, 
altuic - Allows creation if the owner of the image file 

for the current process has access as described above, 
bypass - Allows the process to create the file independent 

of the file protection, 
system - Allows creation if the system has access as 

described above. 
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Parameters: 
fname 



mode 



Address of a null terminated string containing 
the name of the file to be created. The string 
will be translated automatically, by the MCS to 
its logical equivalence. This string may 
contain up to 93 significant characters followed 
by a null. 

Bit encoded long word specifying the type of access 
required. The following description explains the 
options when the specified bit is set (1) . 



Bit Name 
opreadacc 

opwriteacc 

opreadlock 



opwritelock 



opdelete 
opappend 



opfastread 



opnextfile 



Bit Description 

Read access - Requests permission 
to read the file. 

1 Write access - Requests permission 
to write the file. 

2 Read lock - Requests permission 
for exclusive read access to the 
file. 

3 Write lock - Requests permission 
for exclusive write access to the 
file. 

4 Delete - Requests that the file 
be deleted upon closing 

5 Append - Specifies that the initial 
file position be at the logical end 
of file. 

6 Fast read - Specifies that the file 
will be read asynchronously. That 
is, that control returns to the user 
process before the data has actually 
been read. As records are read, they 
will be transferred directly into 
the process's logical address space, 
bypassing the device cache. This bit 
is only valid for disk class 
devices. Other requirements are: 
1) Supports requests for complete 
sectors only, 2) Process's buffer 
must be on a word boundary, 3) The 
request cannot cross a 4-Kbyte page 
boundary. Use the _frowait system 
call to determine when asynchronous 
reads are complete. 

7 Open next file - On a tape device, 
specifies to open open the 'next' 
file without regard to the file's 
name. 
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_creats 



opnordahead 



opnotruncfile 9 



cropenifthere 10 



cropenshared 11 



reclen 



8 No read ahead - Specifies that read 
ahead is not to be done on the 
opened file. 

No truncate - Specifies that when 
the file is closed the extra 
physical sectors allocated to the 
file are not to be released. 
Open if there - Specifies that the 
file will be opened if it exists. 
Only if it does not exist will it 
be created. If the file does exist 
and this bit is set, the ftype, 
prot, uic, fid, mstime, and lstime 
parameters are ignored. The reclen 
parameter will specify the record 
length for this open and does not 
alter the default record length 
associated with the file. 
Open shared - Specifies that if the 
current process or any ancestor of 
the current process has a file with 
the specified name (fname) and with 
the same access modes currently 
open, this process will share the 
file with the ancestor, including 
the default file position. As the 
file is read or written, the default 
position is adjusted for both the 
current process and the ancestor, 
opzerodelete 12 Zero delete - Zero each sector of 

the file before deleting the file, 
ftiis bit is only valid if the file 
is being deleted (via cldelete or 
some other way) . 
13-31 Reserved. Must be set to zero. 
Default file Record length in bytes. Must be between 
and 65535. In the case of the 'open if there* mode 
and the file exists, this parameter overrides the 
default record length specified for the file. 
If a zero or $FFFFFFFF (-1) is used, the file will be 
created with a record length of 1. In the case that 
the named file exists and the 'Open if there* bit is 
set, a $FFFFFFFF (-1) signifies that the default length 
of the specified file is to be used. 
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lun 
status 

Diagnostics : 



- Address of a long word to receive the logical unit number 
of the open file. 

- Address of a long word to receive the result of 
the operation. 



errnomemavail (7) 

errinwernum (129) 

errinvdevnam (130) 

errundevnam (131) 

errfilexists (134) 

errinvreclen (138) 

errinvfiletype (139) 

errnoexecpriv (143) 

errnoreadpriv (144) 

errnowritepriv (145) 

er rnodelpr iv ( 146 ) 

errinvfnstr (147) 

errinvdirfle (148) 

errinvdirstr (149) 

errinvcloper (173) 



errdirnotfnd 
errdirinwer 

errfilopen 



(177) 
(200) 

(202) 



See Also: 



All available memory has been allocated. 

A file's version number cannot be greater than 

65535. 

The specified devicename is syntactically 

incorrect. 

The MCS does not recognize the devicename. 

Is the device mounted? 

The specified version of the file already exists. 

Edit mode 3 requires that the file's record 

length be set to one. 

The specified file type is reserved for the MCS. 

The process does not have Execute Privilege 

for the file. 

The process does not have Read Privilege for 

the file. 

The process does not have Write Privilege for 

the file. 

The process does not have Delete Privilege for 

the file. 

The specified filename is syntactically incorrect. 

The specified directory is not a directory. 

The specified directory name is syntactically 

incorrect. 

The device class is inappropriate for the 

operation. 

The specified directory does not exist. 

A directory file cannot have a version number 

greater than one. 

The process tried to simultaneously open more 

than one tape file. 



_close - Close a file 

_create - Create a file 

_defprot - Set default protection mask 

_delete - Delete a file 

_open - Open a file 

_setfprt - Set file protection 
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Assembler Calling Sequence: 



push 


fname 


push 


mode 


push 


reel en 


push 


lun 


push 


status 


jsr 


_creats 



C Function Declaration: 



long 






_creats 


(fname, mode f reclen, 




char fname [94] ; 




long 


mode; 




long 


reclen; 




long 


*lun; 
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;address - file name 

; value - type of access requested 

; value - record length 

;address - logical unit number 

;address - result of the operation 

simplified file creation 



/* simplified file creation */ 
/* returns result of the operation */ 
lun) 
/* file name */ 

/* type of access requested */ 
/* record length */ 
/* logical unit number 



FORERAN Subroutine Declaration: 



I simplified file creation 
subroutine _creats( fname, mode, reclen, lun, status) 

character*94 fname ! file name 

integer *4 mode I type of access requested 

1 record length 

I logical unit number 

I result of the operation 



integer *4 reclen 
integer *4 lun 
integer *4 status 



Pascal Procedure Declaration: 



procedure _ereats( 
fname 
mode 
reclen 
var lun 
var status 
) ; external ; 



{** simplified file creation} 
string[933; {** file name) 
longint; {** type of access requested} 
longint; {** record length} 
longint; {** logical unit number} 
longint {** result of the operation} 
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Simplified create process. 

Description: 

This call is identical to __crproc except that several parameters 
are removed. It uses the default of each of the parameters left 
out. 

Each process under control of the operating system must 
be created by a call to this operating system service routine 
(or to __crproc). When a process is created, it is called a 
child process. The process that created it is called its 
parent process. 

This system call allows spawning of child processes. 
Spawned processes run in series. This means that the parent 
process hibernates while the child process runs. When the 
child process terminates, the parent process resumes. The 
completion status of the child is returned to the parent. 

The calling process must have read privilege to the device 
containing the image file, execute privilege to all directories 
in the path leading to the directory containing the image file, 
read privilege to the directory containing the image file and 
execute privilege to the file containing the child process image 
for successful creation of the child process. 

If the image file is specified by fcb.seq number then the 
process must have read privilege to the device containing the 
image file and execute privilege to the file containing the 
image • 

The child process is created with the same privileges, at 
the same priority, with the same time slice, with the same 
user identification code, and the same standard input, output 
and error files as the parent process. 

Related Privileges: 

none - Allows the parent process to create a child 
from an image file to which the parent has 
access as described above. 

bypass - Allows the parent process to create a child 
process independent of the file protection. 

Parameters: 

fname - Address of a 94 byte null terminated string 

specifying the name of the file containing the 
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pname 



and 



cmdlen 
pid 



ccode 



process image. This string will be translated 

automatically by the MCS to its logical equivalent. 

This string may contain up to 93 significant 

characters followed by a null. 

Address of a 17 byte null terminated string 

containing the process name to be given the 

new process. This string is used for human 

identification. (16 significant characters 

plus a null) 

Address of Che command line. The command line 

may contain up to 3072 significant bytes. 

The command line may contain any data whatever 

to be passed from the parent to the child. 

The data appears on the top of the child process's 
stack as the child process begins. The long word 
at the top of the child's stack is the length in 
bytes of the command line. At the location (USP+4) 
on the child's stack is a long word which contains 
the starting address of the command line. 
Length of the command line specified in bytes. 
Address of a long word to receive the pid of the child 
process. If the address of the long word is zero, 
no value is returned. 

Address of a long word to receive the completion code 
returned to the parent by the process responsible for 
terminating the child process. If the child is exited 
as a result of a system violation (memory violation, 
illegal instruction, ...) the system supplies the ccode. 
If the process terminates normally, the process itself 
supplies the ccode. If the process is exited by another 
process, the other process supplies the ccode. If the 
address of the long word is zero, no value is returned. 
Completion codes that may be supplied by the system include 

The system clock reached the value 

specified for __ALARM. 
The process has an undefined trap: 

Divide-by-zero . 
The process has an undefined trap: 

CHK Instruction. 
The process has an undefined trap: 

TRAPV Instruction. 
The process has an undefined trap: 

TRACE. 
The process has an undefined trap: 

1010 Instruction. 
The process has an undefined trap: 

1111 Instruction. 
The process attempted to execute a 

privileged instruction. 
The process attempted to execute an 



erralarmexit 


(28) ' 


errzerodivtrap 


(29) ' 


errchktrap 


(30) 


errtrapvtrap 


(31) 


errtracetrap 


(32) 


errlOlOtrap 


(33) 


errlllltrap 


(34) 


errprivintrap 


(35) 


errillintrap 


(36) 
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errbustrap 
erradrtrap 
errnonexmem 

errmemparity 
errwriteprot 

errundeftrap 

errundefsvc 



Dictionary of MCS System Calls 

crprcs 



illegal instruction. 

(37) The process has a bus error. 

(38) The process has an address error. 

(39) The process attempted to access 

nonexistent memory. 

(40) The process has a memory parity-error. 

(41) The process attempted to write to a 

write-protected page in memory. 

(42) __SETTRP was not used to define a call 

for a trap other than TRAP 0. 

(43) The MCS does not recognize the SVC 

number used by the process. 
(255) [CTRL] c terminated the process. 



errcontccode 

status - Address of a long word to receive the result of 
the operation. 



Diagnostics 



errinsufpriv 

errnomemavail 
ermotimf le 
errimagebmbad 

errinvdevnam 

errundevnam 

errfilnotfnd 
errreadleof 

errnoexecpriv 

errnoreadpriv 

errinvfnstr 
errinvdirf le 
errinvdirstr 

errdirnotfnd 
errf ilopen 



(1) The process lacks the privileges required to 

perform the operation. 
(7) All available memory has been allocated. 
(21) The specified file is not an image file. 
(53) (MCS error) The bitmap changed during the 
creation of the process. 

(130) The specified devicename is syntactically 
incorrect. 

(131) The MCS does not recognize the devicename. 
Is the device mounted? 

(133) The specified file could not be found. 
(140) The process tried to read past the logical end 
of a file. 

(143) The process does not have Execute Privilege 
for the file. 

(144) The process does not have Read Privilege for 
the file. 

(147) The specified filename is syntactically incorrect. 

(148) The specified directory is not a directory. 

(149) The specified directory name is syntactically 
incorrect. 

(177) The specified directory does not exist. 
(202) The process tried to simultaneously open more 

than one tape file. 

Device integrity errors 



See Also: 



crproc - Create a new process 
exproc - Terminate the specified process 
setpnam - Change process name 
setpri - Change priority level 
"settmsl - Change scheduling time slice 
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_setuic - Set process uic 
Assembler Calling Sequence: 



push 


fname 


push 


pname 


push 


cmd 


push 


cmdlen 


push 


pid 


push 


ccode 


push 


status 


jsr 


crprcs 



jaddress - name of image file 

;address - process name 

;address - command line 

jvalue - length of cmd 

jaddress - childs pid 

jaddress - childs completion code 

jaddress - result of the operation 

jsimplif ied create process 



C function declaration: 



/* simplified create process */ 

long /* returns result of the operation */ 

__crprcs (fname, pname, cmd, cmdlen, pid, ccode) 

char fname [94] j /* name of image file */ 

char pname[17]j /* process name */ 

char cmd[3072]j /* command line */ 

long cmdlen j /* length of cmd */ 

long *pidj /* childs pid */ 

long *ccodej /* childs completion code */ 



Fortran Subroutine Declaration: 



subroutine crprcs (fname, 
& ccode, status) 
character*94 fname 
character* 17 pname 
character*(*) cmd 
integer*4 cmdlen 
integer*4 pid 
integer*4 ccode 
integer*4 status 

Pascal Procedure Declaration: 



! simplified create process 
pname, cmd, cmdlen, pid, 

! name of image file 

! process name 

! command line 

! length of cmd 

! childs pid 

! childs completion code 

! result of the operation 



procedure _crprcs( 
fname 
pname 
cmd 

cmdlen 
var pid 
var ccode 
var status 
) j external j 



string[93] j 
string[16] j 
~array__of_char j 
longint j 
longint j 
longint j 
longint 



{** simplified create process} 

{** name of image file} 

{** process name} 

{** command line} 

{** length of cmd} 

{** childs pid} 

{** childs completion code} 

{** result of the operation} 
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_CRPROC 

Create a new process. 

Description: 

Each process under control of the operating system must 
be created by a call to this operating system service routine. 
When a process is created, it is called a child process. 
The process that created it is called its parent process. 

SPAWN and FORK are two different modes of creation. 
Spawned processes run in series. This means that the parent 
process hibernates while the child process runs. When the 
child process terminates, the parent process resumes. The 
completion status of the child is returned to the parent. 

Forked processes run in parallel. The parent process is not 
hibernated, but continues execution immediately after successful 
creation of the child process. 

The calling process must have read privilege to the device 
containing the image file, execute privilege to all directories 
in the path leading to the directory containing the image file, 
read privilege to the directory containing the image file and 
execute privilege to the file containing the child process image 
for successful creation of the child process. 

If the image file is specified by fcb.seq number then the 
process must have read privilege to the device containing the 
image file and execute privilege to the file containing the 
image • 

Without the setpriv privilege, the child may not be given more 
privileges than the parent has. 

The child process is created with the same default device 
and directory as the parent. 

Related Privileges: 

none - Allows the parent process to create a child 
from an image file to which the parent has 
access as described above. The child may not 
be given privileges not possessed by the parent. 

bypass - Allows the parent process to create a child 
process independent of the file protection. 

group - Allows the parent process to create a child 

process with the same group id but a different 
owner id than the parent process has. 

setpriv - Allows the parent process to give the child 
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process more privileges than those possessed 

by the parent, 
setprior - Allows the parent process to initiate a child 

at a higher priority level and/or with a higher 

time slice than the parent, 
world - Allows the parent process to create a child 

with any owner id and group id (uic) whatsoever. 

Parameters : 



mode - Whether the process is spawned or forked. 

A indicates spawn, 1 indicates fork. All other 

values are reserved and should not be used, 
siteid - The site id of the system on which the process 

is to be created. If the site id is zero, the 

process will be created on the same system as 

the calling process, 
fname - Address of a 94 byte null terminated string 

specifying the name of the file containing the 

process image. This string will be translated 

into its logical equivalent. This string may 

contain up to 93 significant characters followed 

by a null, 
pname - Address of a 17 byte null terminated string 

containing the process name to be given the 

new process. This string is used for human 

identification. (16 significant characters 

plus a null) 
priv - The privilege mask contains a bit mask of 

privileges to be given to the child process. 

A -1 indicates that the child should receive 

the same privileges that the parent has. 

Privileges are bit encoded as follows: 

Bit Name Bit # Description 

pcbpvsetpriv setpriv 

pcbpvsystem 1 system 

pcbpvreadphys 2 readphys 

pcbpvwritephys 3 writephys 

pcbpvsetprior 4 setprior 

pcbpvchngsuper 5 chngsuper 

pcbpvbypass 6 bypass 

pcbpvoperator 7 operator 

pcbpvaltuic 8 altuic 

pcbpvworld 9 world 

pcbpvgroup 10 group 

11-31 Reserved. Must be set to zero 
priort - The priority level (0..3) at which the child process 

will execute. Level is the highest priority. 

A minus one (-1) in this parameter means to use the 

same priority as the parent process, 
tslice - The time slice value. The maximum amount of time the 
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child process will be able to run each time it is 
scheduled. This time is specified in .01 milliseconds. 
(A time slice of 100 represents 1 millisecond) 
A minus one (-1) in this parameter means to use the 
same time slice as the parent process. 

uic - The user identification code of the child process. The 
most significant 16 bits represent the owner id and the 
least significant 16 bits represent the group id. 
A minus one (-1) in this parameter means to use the 
same uic as the parent process. 

sysin - Address of a 94 byte null terminated string containing 
the name of the standard input file for the 

child process. This string will be translated automatically 
by the MCS to its logical equivalent. The equivalent 
string will be assigned the logical name "SYS$INPUT' in 
the logical name table of the child process. The string 
passed is NOT checked for validity. It may contain up 
to 93 significant characters followed by a null. 

sysout - Address of a 94 byte null terminated string containing 
the name of the standard output file for the 
child process. This string will be translated automatically 
by the MCS to its logical equivalent. The equivalent 
string will be assigned the logical name " SYSSOUTPUT" in 
the logical name table of the child process. The string 
passed is NOT checked for validity. It may contain up 
to 93 significant characters followed by a null. 

syserr - Address of a 94 byte null terminated string containing 
the name of the standard error file for the 



cmd 



cmdlen 
pid 



ccode 



child process. This string will be translated automatically 
by the MCS to its logical equivalent. The equivalent 
string will be assigned the logical name " SYS$ERR0R" in 
the logical name table of the child process. The string 
passed is NOT checked for validity. It may contain up 
to 93 significant characters followed by a null. 
Address of the command line, (up to 3072 bytes) 
The command line may contain any data whatever 
to be passed from the parent to the child. 

The data appears on the top of the child process's 
stack as the child process begins. The long word 
at the top of the child's stack is the length in 
bytes of the command line. At the location (USP+4) 
on the child's stack is a long word which contains 
the starting address of the command line. 
Length of the command line specified in bytes. 
Address of a long word to receive the pid of the child 
process. Note that this is only valuable in the case 
that the child is forked. If the address of the long 
word is zero, no value is returned. 
Address of a long word to receive the completion code 
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returned to the parent by the process responsible for 
terminating the child process. If the child is exited 
as a result of a system violation (memory violation, 
illegal instruction, ...) the system supplies the ccode. 
If the process terminates normally, the process itself 
supplies the ccode. If the process is exited by another 
process, the other process supplies the ccode. Note 
that the ccode will always be zero for processes that 
are forked. If the address of the long word is zero, 
no value is returned. Completion codes that may be 
supplied by the system include: 

The system clock reached the value 

specified for __ALARM. 
The process has an undefined trap: 

Divide-by-zero . 
The process has an undefined trap: 

CHK Instruction. 
The process has an undefined trap: 

TRAPV Instruction. 
The process has an undefined trap: 

TRACE. 
The process has an undefined trap: 

1010 Instruction. 
The process has an undefined trap: 

1111 Instruction. 
The process attempted to execute a 

privileged instruction. 
The process attempted to execute an 
illegal instruction. 

The process has a bus error. 

The process has an address error. 
The process attempted to access 

nonexistent memory. 
The process has a memory parity-error. 
The process attempted to write to a 

write-protected page in memory. 
_SETTRP was not used to define a call 

for a trap other than TRAP 0. 
The MCS does not recognize the SVC 

number used by the process. 
(255) [CTRL] c terminated the process, 
long word to receive the result of 



erralarmexit 


(28) 


errzerodivtrap 


(29) 


errchktrap 


(30) 


errtrapvtrap 


(31) 


errtracetrap 


(32) 


errlOlOtrap 


(33) 


errlllltrap 


(34) 


errprivintrap 


(35) 


errillintrap 


(36) 


errbustrap 


(37) 


erradrtrap 


(38) 


errnonexmem 


(39) 


errraemparity 
errwriteprot 


(40) 
(41) 


errundef trap 


(42) 


errundef svc 


(43) 


errcontccode (255 
status - Address of a long w 
the operation. 



Diagnostics: 

errinsufpriv 

errnomemavail 
errinvsiteid 



(1) The process lacks the privileges required to 
perform the operation. 

(7) All available memory has been allocated. 

(8) The specified site id does not exist. 
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errnotimf le 


(21) 


errimagebmbad 


(53) 


errinvdevnam 


(130) 


errundevnam 


(131) 


errf ilnotfnd 


(133) 


errreadleof 


(140) 


errnoexecpriv 


(143) 


errnoreadpriv 


(144) 


errinvfnstr 


(147) 


errinvdirf le 


(148) 


errinvdirstr 


(149) 


errdirnotfnd 


(177) 


errf ilopen 


(202) 
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The specified file is not an image file,. 

(MCS error) The bitmap changed during the 

creation of the process. 

The specified devicename is syntactically 

incorrect. 

The MCS does not recognize the devicename. 

Is the device mounted? 

The specified file could not be found. 

The process tried to read past the logical end 

of a file. 

The process does not have Execute Privilege 

for the file. 

The process does not have Read Privilege for 

the file. 

The specified filename is syntactically incorrect. 

The specified directory is not a directory. 

The specified directory name is syntactically 

incorrect. 

The specified directory does not exist. 

The process tried to simultaneously open more 

than one tape file. 

Device integrity errors 



See Also: 



_crprcs - Simplified create process 
exproc - Terminate the specified process 
setnnam - Change process name 
setpri - Change priority level 
settmsl - Change scheduling time slice 
setuic - Set process uic 



Assembler Calling Sequence 



push 


mode 


jvalue - 


push 


siteid 


;value - 


push 


fname 


;address 


push 


pname 


jaddress 


push 


priv 


;value - 


push 


priort 


jvalue - 


push 


tslice 


jvalue - 


push 


uic 


jvalue - 


push 


sysin 


jaddress 


push 


sysout 


jaddress 


push 


syserr 


jaddress 


push 


cmd 


jaddress 


push 


cmdlen 


jvalue - 


push 


pid 


jaddress 


push 


ccode 


jaddress 


push 


status 


jaddress 


jsr 


crproc 


jcreate 
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spawn or fork 

system id 

- name of image file 

- process name 
process privilege 
process priority 
process time slice 
user identification code 

- standard input file 

- standard output file 

- standard error file 

- command line 
length of cmd 

- childs pid 

- childs completion code 

- result of the operation 
a new process 
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C function declaration: 

/* 
long /* 

_crproc (mode, siteid, fname, pname, 
sysout, syserr, cmd, 



long mode; 
long siteid; 
char fname [94] ; 
char pname [ 17] ; 
long priv; 
long priort; 
long tslice; 
long uic; 
char sysin[94] ; 
char sysout [94] ; 
char syserr [94] ; 
char cmd [307 2] ; 
long cmdlen; 
long *pid; 
long *ccode; 

Fortran Subroutine Declaration: 



/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 



create a new process */ 

returns result of the operation */ 

priv, priort, tslice, uic, sysin, 

cmdlen, pid, ccode) 

spawn or fork */ 

system id */ 

name of image file */ 

process name */ 

process privilege */ 

process priority */ 

process time slice */ 

user identification code */ 

standard input file */ 

standard output file */ 

standard error file */ 

command line */ 

length of cmd */ 

childs pid */ 

childs completion code */ 



! create a new process 
subroutine crproc(mode, siteid, fname, pname, priv, 

priort, tslice, uic, sysin, sysout, syserr, cmd, 
cmdlen, pid, ccode, status) 



integer*4 mode 
integer*4 siteid 
character*94 fname 
character* 17 pname 
integer*4 priv 
integer*4 priort 
integer*4 tslice 
integer*4 uic 
character*94 sysin 
character*94 sysout 
character*94 syserr 
character*(*) cmd 
integer*4 cmdlen 
integer*4 pid 
integer*4 ccode 
integer*4 status 

Pascal Procedure Declaration: 

procedure __crproc( 

mode : longint; 
siteid : longint; 
fname : string[93]; 



spawn or fork 

system id 

name of image file 

process name 

process privilege 

process priority 

process time slice 

user identification code 

standard input file 

standard output file 

standard error file 

command line 

length of cmd 

childs pid 

childs completion code 

result of the operation 



{** create a new process} 

{** spawn or fork} 

{** system id} 

{** name of image file} 
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pname 

priv 

priort 

tslice 

uic 

sysin 

sysout 

syserr 

cmd 
cmdlen 

var pid 
var ccode 
var status 
) ; external ; 



string[16] ; 

longint; 

longint ; 

longint; 

longint; 

string [93]; 

string[93]; 

string[93]; 

~array_of__char ; 

longint; 

longint ; 
longint; 
longint 



{** process name} 

{** process privilege} 

{** process priority} 

{** process time slice} 

{** user identification code} 

{** standard input file} 

{** standard output file} 

{** standard error file} 

{** command line} 

{** length of cmd} 

{** childs pid} 

{** childs completion code} 

{** result of the operation} 
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crshdp - Enable/disable crash display. 

Description: 

Enable or disable the crash display report when an error 
occurs in a process. The crash display report is the report 
that is generated by the system which shows the value of the 
processor registers, the system stack, user stack, etc. 

When a process is created, crash displays are enabled. That 
is, if the process performs an invalid operation, e.g. accessing 
non-existent memory or executing an illegal instruction , the 
crash display will be written to the standard error file for 
that process. 

Using this system call the programmer can specify that crash 
displays are to be suppressed. Having the crash display report 
disabled does not affect the normal cleanup, by WMCS, of a 
process when it performs an invalid operation. 

Related Privileges: 

None. 

Parameters : 

mode - A flag indicating whether the crash display report is 
to be enabled or disabled. A value of will disable 
crash display reports, a non-zero value will enable 
crash display reports. 



Diagnostics : 

None. 
See Also: 

None- 
Assembler Calling Sequence: 



push 
jsr 



mode 
_crshdp 



;value - enable or disable 
; enable/disable crash display 



C Function Declaration: 
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void 
_crshdp(mode) 

long mode; 

Fortran Subroutine Declaration: 

c 

subroutine crshdp (mode) 
integer* 4 mode 

Pascal Procedure Declaration: 

procedure crshdp ( 

mode : longint; 
) ; external ; 



/* enable/disable crash display */ 
/* no result */ 

/* enable or disable 



! enable/disable crash display 
I enable or disable 



{** enable/disable crash display} 
{** enable or disable} 
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Set /clear control-c protection. 

Description: 

Enable or disable process termination upon receipt 
of a CTRL/C character. 

Any process which accesses a standard terminal port 
(using __open, _read, _write, __create, _exproc or __crproc) 
will be asynchronously exited if a CTRL/C character is 
received from the terminal. This system call enables 
or disables this feature. 

By default when a process is created the control c 
protection is disabled, i.e. the process will be deleted 
if control c is pressed. 

Note that terminals also have a control C feature 
that determines whether control C characters should 
be passed on to the application program. In order 
for a process to terminate when control C is pressed, 
The process must have been the last process to have 
accessed the terminal, the terminal must be set to 
" CONTROL C" status and the process must not be control 
C protected. 

Related Privileges: 

None. 



Parameters : 
mode 



A flag indicating whether the process 
is to be control C protected. A indicates 
that the process is not protected, i.e. it 
will be deleted when control C is pressed. 



Diagnostics 

none • 
See Also: 



__getdst - Get device status 
setdst - Set device status 

Assembler Calling Sequence: 

push mode 



jvalue - protect or unpr- "^ct 
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jsr _ctrlc 
C function declaration: 



void 
_ctrlc(mode) 

long mode 

Fortran Subroutine Declaration: 



subroutine ctrlc(mode) 
integer*4 mode 

Pascal Procedure Declaration: 

procedure __ctrlc( 

mode : longint 
); external; 



;set/clear control c protection 



/* set/clear control c protection */ 
/* no result */ 

/* protect or unprotect */ 



! set/clear control c protection 
! protect or unprotect 



{** set/clear control c protection} 
{** protect or unprotect} 
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Disconnect all remote connections this process has. 

Description: 

This system call is used to break all logical connections with remote 
machines. It does this fcy deallocating the network links (virtual 
circuits) to the process created by the _connect system call. 

Related Privileges: 

None. 



Parameters: 
status 

Diagnostics : 

None. 
See Also: 



- Address of a long word to receive the result of 
the operation. 



_connect - Make a remote connection 
_disconn - Break a remote connection 
_dconidl - Break all idle remote connections 



Assembler Calling Sequence: 



push 
jsr 



status 
_dconall 



;address - result of the operation 
;break all remote connections 



C Function Declaration: 



long 
_dconall() ; 



/* break all remote connections */ 
/* returns result of the operation */ 
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FORTRAN Subroutine Declaration: 

c 1 break all remote connections 

subroutine __dconal( status) 

integer*4 status ! result of the operation 

Pascal Procedure Declaration: 

procedure _dconall( {** break all remote connections } 

var status : longint {** result of the operation } 
) ; external ; 
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Disconnect the idle remote connections this process has. 

Description: 

This system call is used to break all logical connections that are 
currently idle. It does this by deallocating the network links 
(virtual circuits) to the process created by the _connect system 
call. A connection is considered idle if no files are open on the 
remote system and if your default directory is not on the remote 
system. 

Related Privileges: 

None. 

Parameters: 

status - Address of a long word to receive the result of 
the operation. 

Diagnostics : 

None. 

See Also: 

_connect - Make a remote connection 
_disconn - Break a remote connection 
_dconall - Break all remote connections 

Assembler Calling Sequence: 

push status ; address - result of the operation 

jsr _dconidle ;break all idle remote connections 

C Function Declaration: 

/* break all idle remote connections */ 
long /* returns result of the operation */ 

_dconidle() ; 
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FORIKAN Subroutine Declaration: 

c ! break all idle remote connections 

subroutine _dconid( status) 

integer *4 status ! result of the operation 

Pascal Procedure Declaration: 

procedure _dconidle( {** break all idle remote connections } 

var status : longint {** result of the operation } 
) ; external ; 
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Deallocate an allocated device. 

Description: 

This SVC is used to deallocate a 
allocated using the _alloc SVC. 

Related Privileges: 



device which was previously 



none 

group 

world 

Parameters: 
dname 



status 



- Allows deallocation of a device which is currently 
allocated to a process with the same owner id 

and group id (uic) as the calling process. 

- Allows deallocation of a device which is 
allocated to a process with the same group id 

but a different owner id than the calling process. 

- Allows deallocation of a device allocated to any 
process whatsoever. 



Address of a null terminated string identifying 

the specific device which is to be deallocated. 

This string will be translated automatically by 

WMCS into its logical equivalent. The string 

may contain up to 93 significant characters followed 

by a null, but must translate to a valid device name 

of not more than 27 characters (16-character nodename 

with two underscores and an 8-character devicename 

with one underscore and a null) . 

Address of a long word to receive the result of 

the operation. 



Diagnostics: 

errinsufpriv 

errnotalloc 
errnamenull 

See Also: 



(1) The process lacks the privileges required 

to perform the operation. 
(16) The specified device is not allocated. 
(80) The specified name must not be null. 



_alloc - Allocate a device 

_getalc - Get names of allocated devices 

_getrel - Get names of rotor list elements 

_getrtr - Get rotor list names 

_setrtr - Assign device names to a rotor list 
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Assembler Calling Sequence: 



push 
push 
jsr 



dname 

status 

_dealloc 



C Function Declaration: 



long 

_dealloc (dname) 

char dname [941 

P0R3RAN Subroutine Declaration: 



; address - device name 

; address - result of the operation 

; deallocate an allocated device 



/* deallocate an allocated device */ 
/* returns result of the operation */ 

/* device name */ 



c I deallocate an allocated device 

subroutine _deallo (dname , status) 

character *94 dname 1 device name 

integer*4 status 1 result of the operation 

Pascal Procedure Declaration: 

procedure _dealloc( {** deallocate an allocated device) 

dname : string [ 933; {** device name) 

var status : longint {** result of the operation) 
) ; external ; 
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defdprt 



defdprt - Set default device protection. 

Description: 

Establishes the default protection to be applied to a device. 
The default protection is the protection that is assigned to 
a device when the device is not being referenced by any process. 

Device protection can be assigned with the setdprt systan call. 
But* as soon as the device is not being referenced (no process 
has the device, or any file on the device open) the protection 
reverts back to the most recently defined default protection. 

If no default protection has been assigned, the protection 

of the device does not change when the device is not referenced. 

This operation is valid for any mounted device. 

To successfully change protection on a device the process must 
have operator privilege or bypass privilege. 

Related Privileges: 

None - The process can not change the default protection of 

a device, 
bypass - Allows the process to change the default protection on 

any device, 
operator - Allows the process to change the default protection on 

any device. 

Parameters : 

dname - Address of a null terminated string containing the 

the name of the device whose protection is to be set. 
This string may contain up to 93 significant characters 
followed by a null. This string will be translated 
automatically by the MCS to its logical equivalent. 
If this string contains a file designation* the 
devicename portion of the file designation is used for 
this parameter. 

prot - File protection mask. The least significant 
16 bit word of this parameter is divided into 
4 nibbles. Each nibble corresponds to a class 
of users. The bits within each nibble represent 
the type of access that class of user is granted 
for this device. If the bit is set (1) the access 
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is granted. 



From the least to the most significant nibble 
the user classes are: 

Ownr - device owner 

Grp - processes with the same group id as the owner 

Pub - all other processes in the system 

Sys - processes with SYSTEM privilege 

Sys Pub Grp Ownr 

lEWRElEWRElEWRElDWREl 



MSB LSB 



From the least to the most significant bits within 
the nibbles, the access privileges are: 

E - Execute access 

R - Read access 

W - Write access 

D - Delete access 

A long word -1 ($FFFFFFFF) is a reserved value that 

means that the user's default protection mask is to be used, 

status - Address of a long word to receive the result of 
the operation. 

Diagnostics : 

errinsufpriv (1) The process lacks the privileges required to 

perform the operation, 
errinvdevnam (130) The specified devicename is syntactically 

incorrect, 
errundevnam (131) The MCS does not recognize the devicename. 

Is the device mounted? 

Device integrity errors 

See Also: 

_defprot - Set default protection mask 
_getdprt - Get device protection 
_getfprt - Get file protection 
_setdprt - Set device protection 
_setfprt - Set file protection 

Assembler Calling Sequence: 
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push dname 

push prot 

push status 

jsr _defdprt 

C function declaration: 



long 

_defdprt (dname. prot) 

char dname [94] ; 

long prot; 

Fortran Subroutine Declaration: 



subroutine defdpr (dname 
character*94 dname 
integer *4 prot 
integer*4 status 

Pascal Procedure Declaration: 

procedure defdpr t ( 

dname : string [ 93 ] ; 

prot : longint; 
var status : longint 
) ; external; 



; address - device name 

; value - protection mask 

; address - result of the operation 

;set default device protection 



/* set default device protection */ 
/* returns result of the operation */ 

/* device name */ 

/* protection mask */ 



! set default device protection 
prot. status) 
! device name 
I protection mask 
! result of the operation 



{** set default device protection} 

{** device name} 

{** protection mask} 

{** result of the operation} 
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DEFDUIC 



defduic 



def duic - Set default device UIC. 

Description: 

This system call allows a process to change the default user 
identification code (uic) of a device. Given the correct 
privileges a process can change the uic of a device with the 
__setduic svc. As soon as no processes have a device open* 
it's uic will revert back to this default value. When a device 
is first mounted the default device uic value is the same as 
the device uic. By changing the uic the ownership of the 
device is changed. 

To successfully change the uic of a device, either the device 
must have the UNOWNED uic ([ 0000 , 0001] ) or the calling 
process must have operator privilege, and either group 
privilege or world privilege. 

If the calling process has group privilege, and the group 
id of the device is the same as the group id of the calling 
process, the process can modify the owner id of the device. 

If the calling process has world privilege and operator 
•privilege it can change the uic of any device to be any 
other uic except zero. 

This system call is valid for any class of device. 

Related Privileges: 

none - If the device has the UNOWNED uic ([0000,0001]) the 
process can change the uic of the device to the same 
uic as the calling process. 

group - If the process also has operator privilege, it can 
modify the owner id of any mounted device which has 
the same group id as the calling process. If the 
process does not have operator privilege but the 
device has the UNOWNED uic ([0000,0001]) the process 
can set the group id to it's own group id, and it can 
set the owner id to any value. 

operator- Allows setting the uic if the process also has 
either group or world privilege. 

world - If the process also has operator privilege, it can 
modify the uic of any mounted device to any other 
uic except zero. If the process does not have 
operator privilege but the device has the UNCMJED 
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Parameters : 



dname 



uic 



status - 



uic ([0000,0001]) the process can set the uic of the 
device to any other uic except zero. 



Address of a null terminated string containing the 
name of the device whose uic is to be changed. This 
string will be translated automatically by the MCS 
to its logical equivalent. This string may contain 
up to 93 valid characters followed by a null byte. 
If this string contains a file designation* the 
devicename portion of the file designation is used for 
this parameter. 

A long word containing the user identification 
code. This long word is divided into two fields. 
The most significant 16 bits constitute the owner 
id number. The least significant 16 bits constitute 
the group id number (identifying the group to which 
the user belongs) . 

The value $FFFFFFFF (-1) is a reserved value that 
means to use the default uic, i.e. the uic of the 
calling process. 

A value of zero is invalid. 

Address of a long word to receive the result of 

the operation. 



Diagnostics : 

errinsufpriv (1) 

errinvdevnam (130) 

errundevnam (131) 



The process lacks the privileges required to 

perform the operation. 

The specified devicename is syntactically 

incorrect. 

The MCS does not recognize the devicename. 

Is the device mounted? 



See Also: 



_getduic 

_getfuic 

_getuic 

_setduic 

_setfuic 

_setuic 



Get device uic 
Get file uic 
Get process uic 
Set device uic. 
Set file uic 
Set process uic 



Assembler Calling Sequence: 



push 
push 
push 



dname 

uic 

status 



; address - device name 
;value - owner id code 
; address - result of the operation 
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defduic 



jsr _defduic 
C Function Declaration: 



long 

_def duic (dname » uic) 

char dname[94] ; 

long uic; 

Fortran Subroutine Declaration: 



;set default device uic 



/* set default device uic */ 

/* returns result of the operation */ 

/* device name */ 
/* owner id code */ 



! set default device uic 
subroutine defdui (dname. uic f status) 
character*94 dname ! device name 
integer*4 uic I owner id code 
integer* 4 status I result of the operation 



Pascal Procedure Declaration: 

procedure defduic ( 

dname : string [93]; 

uic : longint; 
var status : longint 
) ; external; 



{** set default device uic} 

{** device name} 

{** owner id code} 

{** result of the operation} 
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defmem 



defmem - Define named shared memory area. 

Description: 

Named sharable memory areas are created with defmem. Named sharable 
memory areas are sections of system memory which have an associated 
name. Using this name/ a process may request that this section of 
memory be mapped into its logical memory space which extends from 
address $00001000 through address $001fefff . The size of these 
memory areas will be some multiple of the hardware page size which 
is 4K bytes. 

A process which wants to create a named sharable memory area must 
first have allocated the memory to itself. This may have happened 
at initial program load time or the process may use the normal memory 
allocation routines to cause additional system memory to be mapped 
into empty portions of his logical address space. After having 
initialized this memory space , the process calls _defmem to make 
this memory space to available to other processes. 

After having called _defmem. the named- sharable memory area is 
defined and has one process, that of the definer, which references it. 
At the time that no more processes reference the named sharable 
memory area, the system will deallocate the memory and return it to 
the free memory list. If desirable, the linger bit may be set which 
will cause the named sharable memory area to remain defined even 
though no process references it. In this case» an explicit call to 
_udefmem is needed to deallocate the memory area. 



Related Privileges: 



None 
group 

world 

Parameters : 
mname 



- The defined memory area may not have a uic other 
than that of the calling process. 

- Allows the process to define a memory area with the 
same group id but a different owner id than the 
calling process. 

- Allows the process to define a memory area with any 
uic. 



- Address of a null terminated string containing 
the name to be assigned to the memory area. This 
string will be translated automatically by WMCS 
into its logical equivalent. This string may 
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defmem 



contain up to 93 significant characters followed 
by a null. 

adr - A long word containing the location in local user 

logical memory where the shared memory area will 
start, 

size . - A long word containing the length in bytes of the 

new memory area. The value saved in the control 
structure will be rounded up to the hardware page 
size. 

uic - A long word containing the user identification code 

(uic) specifying the owner of the memory area. 
The most significant 16 bits of this parameter 
contain the owner id while the least significant 
16 bits contain the group id. A value of 
SFFFFFFFF (-1) is a reserved value which means to 
give the memory are the same uis as the calling 
process. 

prot - File protection mask. The least significant 

16 bit word of this parameter is divided into 
4 nibbles. Each nibble corresponds to a class 
of users. The bits within each nibble represent 
the type of access that class of user is granted 
for this memory area. If the bit is set (1) the 
access is granted. 

From the least to the most significant nibble 
the user classes are: 

Ownr - memory area owner 

Grp - processes with the same group id as 

the owner 
Pub - all other processes in the system 
Sys - processes with SYSTEM privilege 

Sys Pub Grp Ownr 

IDWREIDWREIEWREIDWREI 



MSB LSB 



From the least to the most significant bits within 
the nibbles, the access privileges are: 

E - Execute access 

R - Read access 

W - Write access 

D - Delete access 

The value $FFFFFFFF (-1) is a reserved value that 
means that the users default protection mask is to 
be used. 
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mode 



status 



A long word which contains the linger bit which 
allows the memory area remain even though no one 
is currently referencing it. 
BIT # NAME DESCRIPTION 

linger NSM remains defined after 

process dies. 
Address of a long word to receive the result of 
the operation. 



Diagnostics : 

errinsufpriv 

errnonowned 
errsizovfl 
errnamenull 
errnameexists 

See Also: 

_udefmem 

_shrmem 

_ushrmem 

__getxttlst 

__setmuic 

_setmprt 



( 1) 



6) 
60) 
80! 
81) 



( 80) 



The process lacks the privileges required 

to perform the operation. 
Attempt to affect non-owned memory. 
The size passed to the MCS is out of range, 
The name specified must not be null. 
The name specified already exists. 



Undef ine a named sharable memory area. 
Share a named sharable memory area. 
Unshare a named sharable memory area. 
Get a list of named snarable memory areas. 
Change owner of a named sharable memory area. 
Change protection of a named sharable memory area. 



Assembler Calling Sequence: 



address - memory area name 
value - address of memory area 
value - size of memory area 
value - user identification code 
value - memory area protection 
value - mode flags 
address - result of the operation 
define named shared memory area 



C Function Declaration: 

/* define named shared memory area 
long /* returns result of the operation 

_def mem (mname , adr , size , uic , prot ,mode ) 



push 


mname 


push 


adr 


push 


size 


push 


uic 


push 


prot 


push 


mode 


push 


status 


jsr 


_defmem 



V 
V 



char 
long 
long 
long 
long 



mname [94] ; 

adr; 

size; 

uic; 

prot; 



/* 
/* 
/* 
/* 
/* 



memory area name */ 
address of memory area */ 
size of memory area */ 
user identification code */ 
memory area protection */ 
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defmem 



long 



mode; 



/* mode flags */ 



FORERAN Subroutine Declaration: 

c I Define named shared memory area 

subroutine defmem (mname , adr, size, uic, prot, mode, status) 



character*94 mname 



integer* 4 
integer* 4 
integer* 4 
integer*4 
integer*4 
integer*4 



adr 
size 
uic 
prot 

mode 

status 



PASCAL Procedure Declaration: 
procedure _defmem( 



mname 


: string [93] ; 


adr : 


: longint; 


size : 


longint; 


uic : 


• longint; 


prot 


. longint; 


mode 


. longint; 


var status 


: longint 


) ; external; 





memory area name 
address of memory area 
size of memory area 
user identification code 
memory area protection 
mode flags 
result of the operation 



{** define named shared memory area} 

{** memory area name} 

{** address of memory area } 

{** size of memory area } 

{** user identification code} 

{** memory area protection} 

{** mode flags } 

{** result of the operation} 
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Set default protection mask. 
Description: 

Specifies to the system the protection to be applied to 
newly created files when the _create 'prot' parameter is 
(-1), This mask will be used for any files created by 
the current process and any child processes of the current 
process. 

Related Privileges: 

None. 

Parameters: 



prot 



File protection mask. The least significant 
16 bit word of this parameter is divided into 
4 nibbles. Each nibble corresponds to a class 
of users. The bits within each nibble represent 
the type of access that class of user is granted 
for this file. If the bit is set (1) the access 
is granted. 

From the least to the most significant nibble 
the user classes are: 

Ownr - file owner 

Grp - processes with the same group id as the owner 

Pub - all other processes in the system 

Sys - processes with SYSTEM privilege 

Sys Pub Grp Ownr 
, , j 1 1 

| DWRE | DWRE | DWRE | DWRE | 
, 1 

MSB LSB 

From the least to the most significant bits within 
the nibbles, the access privileges are: 





E 


- Execute access 




R 


- Read access 




W 


- Write access 




D 


- Delete access 


Diagnostics : 






None . 
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defprot 



See Also: 



create - Create a file 

creats - Simplified file creation 

getprot - Get default protection mask 
"setfprt- Set file protection 



Assembler Calling Sequence: 



push 
jsr 



prot 
defprot 



C Function Declaration: 



void 

__defprot ( prot ) 
long prot; 

Fortran Subroutine Declaration: 



subroutine defpro(prot) 
integer*4 prot 

Pascal Procedure Declaration: 

procedure _defprot( 

prot : longint 
) ; external; 



;value - protection mask 
;set default protection mask 



/* set default protection mask */ 
/* no result */ 

/* protection mask */ 



! set default protection mask 
! protection mask 



{** set default protection mask} 
{** protection mask} 
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DEINST 



Deinstall privileged file. 

Description: 

This call is used to remove entries from the system table of 
installed files- Once a file is deinstalled, it will execute with 
only those privileges owned by the user. That is, it will not have 
any special privileges. 

Related Privileges: 



none 
operator 

Parameters: 

siteid 



fname 
status 



- The process is not allowed to deinstall privileged files. 

- The process can deinstall any installed file. 



- The site id of the system on which the file is currently 
installed. If the value of this parameter is zero, the 
system on which the calling process is running is 
assumed. 

- The name of the file that you wish to deinstall. 

- Address of a long word to receive the result of the 
operation. 



Diagnostics : 

errinsufpriv (1) 

errinvsiteid ( 8) 

erridxrange (56) 

errinwernum (129) 

errinvdevnam (130) 

errundevnam (131) 

errinvfnstr (147) 

errinvdirfle (148) 

errinvdirstr (149) 

errdirnotfnd (177) 



The process lacks the privileges required to 

perform the operation. 

The specified site id does not exist. 

The table ends before the specified occurrence. 

A file's version number cannot be greater than 

65535. 

The specified devicename is syntactically 

incorrect. 

The WMCS does not recognize the devicename. Is 

the device mounted? 

The specified filename is syntactically 

incorrect. 

The specified directory is not a directory-type 

file. 

The specified directory name is syntactically 

incorrect. 

The specified directory does not exist. 
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See Also: 



_getinst - Get installed privileged file 
^install - Install privileged file 



Assembler Calling Sequence: 

push siteid 

push fname 

push status 

jsr _deinst 

C Function Declaration: 



long 

_deinst (siteid, fname) 

long siteid; 

char fname [94] ; 

FORTRAN Subroutine Declaration: 



; value - the system id 
;value - file to deinstall 
;address - result of the operation 
;deinstall privileged file 



/* deinstall privileged file */ 

/* returns result of the operation */ 

/* the system id */ 
/* file to deinstall V 



I deinstall privileged file 
subroutine _deinst (siteid, lun, status) 
integer*4 siteid I the system id 
character *94 fname ! file to deinstall 
integer*4 status ! result of the operation 



Pascal Procedure Declaration: 

procedure _deinst( 

siteid : longint; 
fname : string [93]; 
var status : longint 

) ; external ; 



{** deinstall privileged file} 

{** the system id) 

{** file to deinstall) 

{** result of the operation) 
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Delete a file. 



Description: 

The named file is removed from the file structure, freeing 
the space it had consumed. In the absence of an explicit 
version number, the file with the highest version number 
is deleted. 

This call will result in the file being marked for deletion, 
but the file will not actually be deleted until it is closed 
by all processes. 

Tape files cannot be deleted. 

Unless the process has bypass privilege, it must have read 
and write privilege to the device containing the file, it must 
have execute privilege of all directories in the path leading 
to the file, it must have read and write privilege to the 
directory containing the file, and delete privilege to the file 
itself in order for Che file to be successfully deleted. 

If the fname is specified in fcb.seq number format, the process 
must have read and write privilege to the device, read and write 
privilege to the directory containing the file and delete 
privilege to the file itself. 

Related Privileges: 

None - Allows deletion only if process has access 

to the file as described above, 
altuic - Allows deletion if the owner of image file 

for the current process has access to the file 

as described above, 
bypass - Allows the process to delete the file independent 

of the file protection, 
system - Allows deletion if the system has access to 

the file as described above. 

Parameters: 

fname - Address of a null terminated string containing the 
name of the file to be deleted. This string will 
be translated automatically by the MCS into its 
logical equivalent. This string may contain up to 
93 significant characters followed by a null. 

status - Address of a long word to receive the result of 
the operation. 
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delete 



Diagnostics: 




errinvdevnam ( 


U30) 


errundevnam 


U31) 


errfilnotfnd ( 


U33) 


errnoexecpriv ( 


:u3) 


errnoreadpriv ( 


:i44) 


errnowritepriv ( 


:i45) 


errnodelpriv 


:i46) 


errinvfnstr 1 


:i47) 


errinvdirfle ( 


:i48) 


errinvdirstr < 


:i49) 


erropendel ( 


:i53> 


errdelfile ( 


:i58> 


errinvcloper ( 


:i73) 


errdirnotfnd ( 


:n7) 


errinvseqnum ( 


:i78) 


See Also: 





The specified devicename is syntactically 

incorrect. 

The MCS does not recognize the devicename. 

Is the device mounted? 

The specified file could not be found. 

The process does not have Execute Privilege 

for the file. 

The process does not have Read Privilege for 

the file. 

The process does not have Write Privilege for 

the file. 

The process does not have Delete Privilege for 

the file. 

The specified filename is syntactically incorrect. 

The specified directory is not a directory. 

The specified directory name is syntactically 

incorrect. 

The specified file is open, has been marked 

for deletion. 

System files cannot be deleted. 

The device class is inappropriate for the 

operation. 

The specified directory does not exist. 

The file's FCB.SEQ number in the directory 

file is incorrect. 

Device integrity errors 



_close - Close a file 
__create - Create a file 
__open - Open a file 

Assembler Calling Sequence: 



push 


fname 


push 


status 


jsr 


delete 



C function declaration: 



jaddress - file name 

jaddress - result of the operation 

jdelete a file 



long 
delete (fname) 

char fname [94] ; 

Fortran Subroutine Declaration: 



/* delete a file */ 

/* returns result of the operation */ 

/* file name */ 



! delete a file 
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delete 



subroutine delete(fname, status) 

character*94 fname ! file name 

integer*4 status ! result of the operation 

Pascal Procedure Declaration: 

procedure _delete( {** delete a file} 

fname : string[93]; {** file name} 

var status : longint {** result of the operation} 
) ; external ; 
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_DISCONN 

Break a connection to a remote machine. 

Description: 

This system call is used to break a logical connection with a remote 
machine. It does this fcy deallocating the network link (virtual 
circuit) to the process created by the _connect system call. 

Related Privileges: 

None. 

Parameters: 

siteid - Site ID of the system with which a connection is 

being broken, 
status - Address of a long word to receive the result of 

the operation. 

Diagnostics : 

errinvsiteid (8) The specified site ID does not exist, 
errremotelogon (47) The process was not allowed to log on to the 

remote system 

See Also: 

_connect - Make a remote connection 
_dconall - Break all remote connections 
_dconidl - Break all idle remote connections 

Assembler Calling Sequence: 



push 
push 
jsr 



siteid 
status 
_disconn 



; value - site being disconnected 
;address - result of the operation 
; break a remote connection 
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C Function Declaration: 



long 

_disconn( siteid) ; 

long siteid; 

FORERAN Subroutine Declaration: 



/* break a remote connection */ 

/* returns result of the operation */ 

/* site being disconnected */ 



1 break a remote connection 
subroutine _discon( siteid, status) 

integer *4 siteid 1 site being connected to 
integer*4 status ! result of the operation 



Pascal Procedure Declaration: 

procedure _disconn( 

siteid : longint; 
var status : longint 
) ; external ; 



{** break a remote connection } 
{** site being disconnected } 
{** result of the operation } 
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_DISMNT 

Dismount a logical device. 

Description: 

Removes a device from further consideration by the O.S. 
A device cannot be dismounted if it contains open files. 

After the device is dismounted, if the device driver is 
no longer needed (no other similar devices are mounted), 
the device driver is discarded and the space it occupied 
is returned to the system dynamic memory pool. 

The process dismounting a user device must have either delete 
privilege to the device, or bypass privilege. 

Related Privileges: 



None - Allows dismounting of devices for which the process 

has delete privilege 
bypass - Allows dismounting of any device 



Parameters 
dname 



- Address of null terminated string containing the name 
of the device to be dismounted. This string will be 
translated automatically by the MCS into its logical 
equivalent. This string may contain up to 93 
significant characters followed by a null. 
If this string contains a file designation, the 
devicename portion of the file designation is used for 
this parameter, 
status - Address of a long word to receive the result of 
the operation. 



Diagnostics : 

errinsufpriv 

errinvdevnam 

errundevnam 

errnodelpriv 

errf ilesopen 

errdiffbtblk 



(1) The process lacks the privileges required to 
perform the operation. 

(130) The specified devicename is syntactically 
incorrect . 

(131) The MCS does not recognize the devicename. 
Is the device mounted? 

(146) The process does not have Delete Privilege 

for the file. 
(160) The device cannot be dismounted because files 

are still open on it. 
(168) The boot block has changed since the device 

was mounted. 
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See Also: 



flush - Flush I/O buffers to the device 

getdnam- Get device name 

mount - Mount a logical device 



Assembler Calling Sequence: 



push 


dname 


push 


status 


jsr 


dismnt 



C function declaration: 



long 

__dismnt (dname) 

char dname [94] ; 

Fortran Subroutine Declaration: 



jaddress - device name 

;address - result of the operation 

;dismount a logical device 



/* dismount a logical device */ 

/* returns result of the operation */ 



/* device name */ 



! dismount a logical device 
subroutine dismnt (dname, status) 

character*94 dname ! device name 

! result of the operation 



integer*4 status 

Pascal Procedure Declaration: 

procedure __dismnt( 

dname : string[93]; 
var status : longint 
) ; external ; 



{** dismount a logical device} 

{** device name} 

{** result of the operation} 
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_DUH,UN 

Duplicate a logical unit number of a file. 

Description: 

Given a valid logical unit number dun) , duplicate it. That is, make 
the file accessible via a new lun. Both the original and the new lun 
share the same characteristics and position in the file. 

Related Privileges: 

None. 



Parameters: 

lun 

newlun 

status 



Diagnostics : 



- Logical unit number to duplicate. 

- The new duplicate logical unit number. 

- Address of a long word to receive the result of 
the operation. 



errnomemavail 
errinvlfn 



(7) All available memory has been allocated. 
(132) The logical unit number does not correspond 
to an open file. 



See Also: 



.create - Create a file 
_open - Open a file 

Assembler Calling Sequence: 



push 


lun 


push 


newlun 


push 


status 


jsr 


_duplun 



C Function Declaration: 



long 

_duplun (lun r newlun) 

long lun; 

long *newlun; 



;value - logical unit number 
;address - new logical unit number 
; address - result of the operation 
/duplicate an existing lun 



/* duplicate an existing lun */ 

/* returns result of the operation */ 

/* logical unit number */ 
/* new logical unit number */ 



DUH.UN-1 



Dictionary of WMCS System Calls 
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FORTRAN Subroutine Declaration: 

c 1 duplicate an existing lun 

subroutine _duplun(lun/ newlun, status) 

integer*4 lun I logical unit number 
integer *4 newlun 1 new logical unit number 
integer*4 status ! result of the operation 

Pascal Procedure Declaration: 

procedure _duplun( {** duplicate an existing lun) 

lun : longint; {** logical unit number} 

var newlun : longint; {** new logical unit number) 

var status : longint {** result of the operation) 

) ; external ; 
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errno 



errno - Receive process short reason. 

Description: 

Obtain the process abort reason from the process control block 
(pcb) for any process in the system. 

This call is most useful if called from an exit handler. With 
this svc a process can obtain the reason it entered its exit 
handler, i.e. the reason it is being terminated. 

The value will be zero if the process has not terminated yet. 

Related Privileges: 

none - Allows process to obtain the abort reason for any process 

with the same owner id and group id (uic) as the calling 

process, 
group - Allows process to obtain the abort reason for any process 

with the same group id as the calling process, 
world - Allows process to obtain the abort reason for any process 

in the system. 

Parameters : 

pid - Process ID of the process whose abort reason is to be 

obtained. refers to the calling process, -1 refers 

to the parent of the calling process, 
reason - Address of a long word to receive the reason the given 

process terminated. This value will be zero if the 

process has not terminated yet. 
status - Address of a long word to receive the result of 

the operation. 

Diagnostics : 

errinsufpriv (1) The process lacks the privileges required to 

perform the operation, 
errprcsnotfnd (2) The specified process is not in the system 

process table. 

See Also: 

_jsetexit - Define exit handler. 
Assembler Calling Sequence: 

ERRNO-1 



Dictionary of WMCS System. Calls 
errno 



push pid 

push reason 

push status 

jsr _errno 

C function declaration: 



long 

_errno(pid, reason) 

long pid; 

long * reason; 

Fortran Subroutine Declaration: 



; value - process id 
; address - receives abort reason 
; address - result of the operation 
; receive process abort reason 



/* receive process abort reason 

/* returns result of the operation */ 



/* process id */ 



/ 



* receives abort reason 



V 



I receive process abort reason 
subroutine errno (pid, reason, status) 
integer*4 pid ! process id 

integer*4 reason ! receives abort reason 

integer*4 status ! result of the operation 



Pascal Procedure Declaration: 

procedure errno ( 

pid : longint; 

var reason : longint; 

var status : longint 
) ; external ; 



{** receive process abort reason} 

{** process id} 

{** receives abort reason} 

{** result of the operation} 
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Define a returnable exit handler. 

Description: 

The user may define an exit handler to be executed when the process 
is deleted. An exit handler can be used as a cleanup and restore 
routine or as a mechanism for "catching" otherwise fatal errors. Use 
of this SVC also allows a process to return to the point from which 
the process was exited instead of merely altering the path to final 
exit. The return feature allows processes to use the exit handler as 
a software interrupt routine. Other processes send the interrupt 
using the __exproc system call and mutually recognized abort codes. 

Return code values from -65535 to -4096 are for users to define as 
they wish. Values from -4095 to +4095 are reserved for WMCS. Values 
from +4096 to +65535 are also for users to define. The abort code can 
be determined using the _errno system call. Exit routines cannot have 
any call arguments. 

The exit handler for a process is executed when a process exits 
regardless of the cause or circumstances of the exit. The exit 
handler is executed in the same processor mode (user or supervisor 
mode) as the mode from which the exit handler was defined. 

When control is passed to the exit handler the OS notes that the 
process is executing its exit handler. If a fatal process error 
occurs while the process is executing its exit handler, the process 
will be deleted without passing through the exit handler again. If 
the process wants an exit handler to be called again as the process 
exits, it must define a new exit handler while it is executing its 
exit handler. Since no further abort conditions will be honored 
until the next time the process is scheduled, a carefully written 
exit handler can determine the reason for being transferred to the 
exit handler and be able to define a new one if necessary. 

To terminate the process normally once the exit handler has been 
called, issue a call to _exproc from within the exit handler. 

When a returnable exit handler is called, the registers contain the 
context of the process at the point it was interrupted. The top of 
the stack contains a return address to a piece of runtime code which 
will execute an R3R or RTE instruction upon return from the exit 
handler. The actual return address and status register of the 
interrupted process are stored at 6 and 4 bytes respectively from the 
top of the stack. Because an exithandler is capable of being called 

EXITRON-l 



Dictionary of WMCS System Calls 
_exitrtn 



asynchronously in relation to the main process f changing global 
variables from within an exit handler may cause seemingly mysterious 
results when control is returned to the main body of a process which 
uses those same variables. 

Related Privileges: 

None. 

Parameters: 

adr - Address of the first executable instruction of the 
exit handler to be called upon process exit. 

Diagnostics : 

None. 

See Also: 

_errno - Receive process abort reason 
_exproc - Terminate the specified process 
_setexit - Define an exit handler 



Assembler Calling Sequence: 



push 
jsr 



adr 
_exitrtn 



C Function Declaration: 

void 
_exitrtn (adr) 

long adr; 

FORTRAN Subroutine Declaration: 

c 



;exit handler address 

;def ine a returnable exit handler 



/* define a returnable exit handler */ 
/* no status is returned */ 

/* exit handler address */ 



! define a returnable exit handler 
subroutine _exitrt(adr) 

external adr 1 name of exit hander process 



Pascal Procedure Declaration: 

procedure _exitrtn( 

adr : longint 
) ; external; 



{** define a returnable exit handler} 
{** exit handler address) 
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_EXPROC 

Terminate the specified process. 

Description: 

The specified process is terminated , returning a 32-bit return code 
to the parent of the terminated process. Hie return code is received 
in the ccode parameter of the __crproc system call. 

Return code values from -65535 to -4096 are for users to define as 
they wish. Values from -4095 to +4095 are reserved for WMCS. Values 
from +4096 to +65535 are also for users to define. 

If the terminated process has an exit handler defined , it can request 
the "result" parameter using the _errno system call. 

Related Privileges: 

none - Allows termination of any process with the same 

owner id and group id (uic) as the calling process 

group - Allows termination of any process with the same 
group id as the calling process 

world - Allows termination of any process in the system 

Parameters: 

pid - The process id (pid) of the process to be terminated 
A process id of represents the current process. A 
process id of -1 represents the parent of the current 
process. 

result - 32 bit result returned to the parent of the terminated 
process. 

status - Address of a long word to receive the result of 
the operation. 

Diagnostics : 

errinsufpriv (1) The process lacks the privileges required to 

perform the operation, 
errprcsnotfnd (2) The specified process is not in the system 

process table. 
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Dictionary of WMCS System Calls 
_exproc 



See Also: 



_crprcs - Simplified create process 
_crproc - Create a new process 
_exitrtn - Define a returnable exit handler 
_setexit - Define exit handler 



Assembler Calling Sequence: 



push 
push 
push 


pid 

result 

status 


jsr 


_exproc 



C Function Declaration: 



long 
_exproc 



(pid, result) 
long pid; 
long result; 



; value - process id 

; value - return code 

; address - result of the operation 

; terminate the specified process 



/* terminate the specified process */ 
/* returns result of the operation */ 



/* process id */ 
/* return code */ 



FORTRAN Subroutine Declaration: 



subroutine _exproc(pid, 
integer*4 pid 
integer*4 result 
integer*4 status 

Pascal Procedure Declaration: 

procedure _exproc( 

pid : longint; 
result : longint; 
var status : longint 

) ; external ; 



! terminate the specified process 
result, status) 
i process id 
! return code 
1 result of the operation 



{** terminate the specified process) 

{** process id) 

{** return code) 

{** result of the operation) 
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_FLUSH 

Flush I/O buffers to the device. 

Description: 

Write all of the modified device cache buffers and modified 
file control blocks (fcb's) to the device, making the file 
system on the device current. 

Requires that the process have write privilege to the device 
being flushed. 

Related Privileges: 

None - Allows a process with write privilege to the device 

to flush the buffers, 
bypass - Allows a process to flush the buffers independent 

of the file protection, 
operator- Allows a process to flush the buffers independent 

of the file protection. 

Parameters : 

dname - Address of a null terminated string containing the 
name of the device to be flushed. This string is 
translated automatically by the MCS into its logical 
equivalent. This string may contain up to 93 
significant characters followed by a null. 
If this string contains a file designation, the devicename 
portion of the file designation is used for this parameter 

status - Address of a long word to receive the result of 
the operation. 

Diagnostics: 

errinvdevnam (130) The specified devicename is syntactically 

incorrect, 
errundevnam (131) The MCS does not recognize the devicename. 

Is the device mounted? 
errnowritepriv (145) The process does not have Write Privilege 

for the file, 
errinvcloper (173) The operation is inappropriate for the 

device class. 

See Also: 

_close - Close a file 

_dismnt - Dismount a logical device 

getdnam- Get device name 

write - Write to an open file 
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Dictionary of MCS System Calls 
flush 



Assembler Calling Sequence: 



push 


dname 


push 


status 


jsr 


flush 



C function declaration: 

long 

__flush (dname) 

char dname [94] ; 

Fortran Subroutine Declaration: 

c 

subroutine flush(dname, 
character*94 dname 
integer*4 status 

Pascal Procedure Declaration: 

procedure f lush( 

dname : string [93]; 
var status : longint 
) ; external; 



jaddress - device name 

jaddress - result of the operation 

;flush I/O buffers to Che device 



/* flush I/O buffers to the device */ 
/* returns result of the operation */ 

/* device name */ 



! flush I/O buffers to the device 
status) 

! device name 

! result of the operation 



{** flush I/O buffers to the device} 

{** device name} 

{** result of the operation} 
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FRDWAIT 



Wait for fast read to complete. 

Description: 

Given a valid logical unit number, wait for any 
asynchronous read operations to complete. Any errors 
pending from previous asynchronous read operations are 
reported in the status of this system call. 

If there was not a previous asynchronous read, this 
system call returns successfully. 

This call Is only implemented on disk class devices. 
Related Privileges: 

None. 
Parameters: 

lun - The logical unit number of the open file 

on which the fast read was initiated. 

status - The address of a long word to receive the result of 
the operation. 



Diagnostics: 
errinvlfn 
errinvcloper 

See Also: 



(132) The logical unit number does not correspond 

to an open file. 
(173) The device class is inappropriate for the 

operation. 

Device integrity errors. 



_close - Close a file 

_create - Create a file 
_open - Open a file 

__read - Read from an open file 
Assembler Calling Sequence: 



push 


lun 


push 
jsr 


status 
frdwait 



C Function Declaration: 



jvalue - logical unit number 

;address - result of the operation 
;wait for fast read to complete 



/* wait for fast read to complete */ 
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Dictionary of MCS System Calls 
frdwait 



long 

_frdwait (lun) 

long lun ; 

Fortran Subroutine Declaration: 

c 



/* returns result of the operation */ 
/* logical unit number */ 



! wait for fast read to complete 
subroutine frdwai(lun, status) 



integer*4 lun 
integer*4 status 

Pascal Procedure Declaration: 

procedure __frdwait( 

lun : longint; 
var status : longint 
); external; 



! logical unit number 

! result of the operation 



{** wait for fast read to complete} 
{** logical unit number} 
{** result of the operation} 
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_FREMEM 

Deallocate a page of memory. 

Description: 

This supervisor call allows a process to remove a four kilobyte 
page of logical memory from its pcb. Unless the page is shared 
by another process, it is returned to the system memory pool. 

A process can deallocate any page which has been allocated 
to it and which is owned by the calling process. 

If the process has writephys privilege, it can deallocate any 
page of memory which has been allocated to it, independent 
of whether the page is owned by the calling process. 

Related Privileges: 

none - Allows the process to deallocate any page 

which is allocated to it and which it owns. 

writephys - Allows the process to deallocate any page 
which is allocated to it. 

Parameters: 

adr - Logical address in the 2 megabyte logical address 
space of the page to be deallocated. This address 
must be on a 4K byte boundary. 

status - Address of a long word to receive the result of 
the operation. 

Diagnostics: 

errinvadr (4) The logical address, for the memory requested, 

is invalid, 
errnonowned (6) The process tried to affect a page in memory it 

did not own. 
errraemdeall (9) The process attempted to release memory that does 

not exist. 

See Also: 

_allmem - Allocate dynamic memory 
protmem- Change memory page protection 



Assembler Calling Sequence: 



push 


adr 


push 


status 


jsr 


f rem em 



;value' - address of page 

jaddress - result of the operation 
jdeallocate a page of memory 
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Dictionary of MCS System Calls 
fremem 



C function declaration: 

long 
_fremem(adr) 

long adr; 

Fortran Subroutine Declaration: 
c 



/* deallocate a page of memory */ 

/* returns result of the operation */ 

/* address of page */ 



! deallocate a page of memory 
subroutine fremem(adr, status) 



integer*4 adr 
integer*4 status 

Pascal Procedure Declaration: 

procedure __fremem( 

adr : longint; 
var status : longint 
) ; external ; 



! address of page 

! result of the operation 



{** deallocate a page of memory} 

{** address of page} 

{** result of the operation} 
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J5ASSIGN 

Assign a global logical name. 

Description: 

Creates, deletes or replaces a logical name in the global logical 
name translation table of the current system or another system. 

A system's global logical name table contains logical name 
equivalences that apply to every process in the system. A logical 
name in the global logical name table does not have to be 
duplicated in the logical name table of each forked process. 
Global logical names remain until they are explicitly removed, 
independent of any process on the system. 

Abbreviations are allowed in logical names. An asterisk (*) 

in the logical name is a marker that indicates the minimum 

string that is a recognized abbreviation of the logical name. 

Abbreviations are recognized only during logical name translation 

(see __trans). For example, if the logical name is "PR* INT", 

a translation of any of the strings "PR! 1 , "PRI", "PRIN", or "PRINT" 

will return the equivalence. 

The values of the parameters lname and equiv determine whether 

an entry in the logical name table of the specified process is 
created, removed, or replaced. 

To create a new logical name, the lname parameter must contain 
a logical name which does not match any existing logical names 
in the global logical name table of the specified system and 
the equiv parameter must not be null. 

To remove a logical name assignment, the lname parameter must 

contain a logical name which matches a logical name found in 

the global logical name table of the specified system and the 
equiv parameter must be null. 

To replace the equivalent string associated with a logical name 
the lname parameter must contain a logical name which matches 
an existing logical name found in the global logical name table 
of the specified system and the equiv parameter must not be null. 

If the lname parameter contains a logical name which does 
not match any existing name found in the global logical name 
table and the equiv parameter is null, or if the lname parameter 
is null, this system call has no effect. 

Related Privileges: 
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Dictionary of MCS System Calls 
gassign 



none 



- Does not allow the process to affect any names 
in the global logical name table, 
operator - Allows creation, replacement or deletion of any 
logical name in the global logical name table. 



Parameters : 



lname 



equiv 



siteid 



status 



- Address of null terminated string containing the 
logical name to be added, replaced or deleted from 
the logical name table of the specified system. 

This string may contain up to 93 characters plus a null. 

- Address of null terminated string containing the 
equivalent to which the logical name translates. 
It this parameter contains a null string, the 
logical name represented in parameter lname is 
removed from the logical name table. This string 
may contain up to 93 characters plus a null. 

- A long word containing the site id of the system 
for which this logical name will be in effect. 
0=»the system on which the calling process is 
executing. 

- Address of a long word to receive the result of 
the operation. 



Diagnostics: 

errinsufpriv (1) 

errprcsnotfnd (2) 

errnomemavail (7) 

errinvsiteid (8) 



The process lacks the privileges required to 

perform the operation. 

The specified process is not in the system 

process table. 

All available memory has been allocated. 

The specified site id does not exist. 



See Also: 

^assign 

__getglb 

_getlog 

trans 



Assign a logical name 
Retreive a global logical name 
Retrieve a logical name 
Translate a logical name 



Assembler Calling Sequence: 



push 


lname 


push 


equiv 


push 


siteid 


push 


status 


jsr 


gassign 



C function declaration: 



jaddress - logical name 

jaddress - translation string 

;value - system id 

jaddress - result of the operation 

jassign a global logical name 



/* assign a global logical name */ 



GAS SIGN- 2 



Dictionary of MCS System Calls 

gassign 



long 

__gassign (lname, equiv, siteid) 

char lname [94] ; 

char equiv [94] ; 

long siteid; 

Fortran Subroutine Declaration: 



/* returns result of the operation */ 

/* logical name */ 

/* translation string */ 

/* system id */ 



! assign a global logical name 
subroutine gassig(lname, equiv, siteid, status) 



character*94 lname 
character*94 equiv 
integer*4 siteid 
integer*4 status 

Pascal Procedure Declaration: 



procedure gassign( 



lname 
equiv 
siteid 
var status 
) ; external ; 



string[93] ; 
string[93]; 
longint ; 
longint 



! logical name 

! translation string 

! system id 

! result of the operation 



{** assign a global logical name} 

{** logical name} 

{** translation string} 

{** system id} 

{** result of the operation} 
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_GENGY 

Get PID of ancestor process. 

Description: 

Return the process id (pid) of a specified ancestor 
process of the given process. 

Related Privileges: 

None. 
Parameters : 

refpid - The process id (pid) of the process which will 

serve as the reference point from which ancestors 
or children PID's will be received. If the refpid 
is zero (0), it corresponds to the current process. 
A refpid of $FFFFFFFF (-1) corresponds to the parent 
of the current process. 

rel - Relative relationship with specified process. 

. .., -2=grandparent , -l=parent, 0=current process, 
If the requested relationship goes beyond the actual 
number of ancestors an error is returned. Specify a 
relationship of one (1) to get the pid of the oldest 
ancestor. 

pid - Address of a long word to receive the process id 
of the relative. 

status - Address of a long word to receive the result of 
the operation. 

Diagnostics: 

errprcsnotfnd (2) The specified process is not in the system 

process table. 

See Also: 

_getpcb - Get process control block 
getpid - Get process id (pid) from name 
getpnam- Get process name from pid 



Assembler Calling Sequence: 



push 


refpid 


push 


rel 


push 


pid 


push 


status 


jsr 


gengy 



;value - reference point pid 

;value - relative relationship 

;address - process id 

jaddress - result of the operation 

;get pid of ancestor process 
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Dictionary of MCS System Calls 
gengy 



C function declaration: 



long 

_gengy(refpid, rel, pid) 

long refpid; 

long rel; 

long *pid; 

Fortran Subroutine Declaration 



/* get pid of ancestor process */ 

/* returns result of the operation */ 

/* reference point pid */ 
/* relative relationship */ 
/* process id */ 



! get pid of ancestor process 

subroutine gengy(refpid, rel, pid, status) 

integer*4 refpid ! reference point pid 

integer*4 rel ! relative relationship 

integer*4 pid ! process id 

integer*4 status ! result of the operation 



Pascal Procedure Declaration: 

procedure _jgengy( 

refpid : longint; 

rel : longint; 

var pid : longint; 

var status : longint 
); external; 



{** get pid of ancestor process} 

{** reference point pid} 

{** relative relationship} 

{** process id} 

{** result of the operation} 



GENGY- 2 



GETALC 



getalc 



getalc - Get names of allocated devices 
Description: 

Given a PID, return the names of all devices allocated to that process, 
Related Privileges: 



none 

group 

world 

Parameters : 
pid 
devlst 

maxlen 
status 



- Allows the caller to determine which if any devices are 
allocated to processes with the same uic as the itself. 

- Allows the caller to determine which if any devices are 
allocated to processes in the same group as the itself. 

- Allows the caller to determine which if any devices are 
allocated to any process. 



- Process IDentification number of the process 
which is to be examined for . allocated devices . 

-This parameter is the address of a string buffer 
in which will be placed the names of the devices 
allocated to the specified PID. All names are 
separated by commas. The string is null terminated. 

- This parameter contains the maximum length of the 
devlst string. 

- Address of a long word to receive the result of 
the operation. 



Diagnostics : 

errinsufpriv 
errprcsnotfnd 

See Also: 

_alloc 
_dealloc 
_getrel 
_getrtr 

_setrtr 



( 1) The process lacks the privileges required 

to perform the operation. 
( 2) The specified process is not in the system 

process table. 



Allocate an availble device. 
Deallocate an allocated device. 
Get names of rotor list elements. 
Get rotor list names. 
Assign device names to a rotor list, 



Assembler Calling Sequence: 
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Dictionary of WMCS System Calls 
getalc 



push pid 

push devlst 

push maxlen 

push status 

jsr _getalc 

C Function Declaration: 



long 

_getalc (pid, devlst, maxlen) ; 

long pid; 

char devlst [1024] ; 

long maxlen ; 

FORTRAN Subroutine Declaration: 



value - process id 

address - string where devices return 

value - max length of devlst 

address - status 

get names of allocated devices 



/* get names of allocated devices */ 
/* returns result of the operation */ 

/* process id */ 

/* string where devices return */ 

/* max length of devlst */ 



! get names of allocated devices 
subroutine getalc (pid, devlst , maxlen, status) 
integer*4 pid ! process id 
character*1024 devlst ! string where devices return 
integer*4 maxlen 1 max length of alcdev 
integer*4 status i result of the operation 



PASCAL Procedure Declaration: 



procedure getalc ( 
pid 
var devlst 
maxlen 
var status 
) ; external ; 



longint; 
string [1024]; 
longint; 
longint 



{** get names of allocated devices} 

{** process id} 

{** string where devices return } 

{** max length of devlst } 

{** result of the operation} 
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jGETATER 

Get PCB attribute bits. 

Description: 

Call this routine to get the process attribute bits in the PCB for a 
particular process. To modify the process attributes of a process, 
use this routine first to get the current ones and set or reset the 
appropriate bits, then call JSETAT'IR with the modified value. The 
pcbattrforceset bit is always returned set. 

Related Privileges: 

None. 



Parameters: 
pid 

attr 



A long word containing the process ID of the process 
whose attributes are to be changed. represents 
the current process; -1 ($FFPFFFFF) represents the 
parent of the current process. 
Address of a long word to receive the attributes. 

Process attribute bit definitions. Note that these 
offsets are defined for being in the high word of a 
longword. Because it is only a word in the PCB, if you 
access the PCB directly you will have to shift these 
numbers right by 16. 



Bit Name 


Bit Number 


Description 


pcbattrdesencrypt 


16 


If set, do network 
encryption with DES 
algorithm. 


pcbattrfastencrypt 


17 


If set, do network 
encryption with fast 
algorithm. 


pcbattruserl 


23 


If set, user 
attribute bit 1. 


pcbattruser2 


24 


If set, user 
attribute bit 2. 


pcbattruser3 


25 


If set, user 
attribute bit 3. 
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Dictionary of WMCS System Calls 
_getattr 



pcbattruser4 


26 


pcbattrnowatchdog 


27 


pcbattr swappabl e 


28 


pcbattr pr ez eromem 


29 



pcbattr postz eromem 3 



pcbattrforceset 31 



If set, user 
attribute bit 4. 
If set, cannot be 
killed by WATCHDOG 
utility. 

If set, the OS will 
not swap this process. 
If set, pages of 
memory are zeroed as 
they are allocated. 
If set, pages of 
memory are zeroed as 
they are released. 
If set, then modify 
the bits. Must be set 
to cause other bits 
to take effect. 



status - Address of a long word to receive the result of 
the operation. 



Diagnostics : 



errprcsnotfnd (2) The specified process is not in the system 

process table. 



See Also: 



_setattr - Set PCB attribute bits 



Assembler Calling Sequence: 



push 


pid 


push 


attr 


push 


status 


jsr 


_getattr 



C Function Declaration: 



long 

_getattr (pid, attr) 

long pid; 

long *attr; 



; value - process id 
;address - to store attribute bits 
; address - result of the operation 
;get the attributes 



/* get process attributes */ 

/* returns result of the operation */ 

/* process id */ 

/* returned attributes */ 
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Dictionary of WMCS System Calls 

_getattr 



FORTRAN Subroutine Declaration: 



c 1 get process attributes 
subroutine _getatt(pid, attr, status) 

integer *4 pid 1 process id 

integer*4 attr I returned attributes 

integer*4 status 1 result of the operation 

Pascal Procedure Declaration: 

procedure _getattr( {** get process attributes} 

pid : longint; {** process id) 

var attr : longint; {** returned attributes} 

var status : longint {** result of the operation} 

) ; external ; 
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GETDIR 



_GETDIR 

Get default device and directory. 

Description: 

Obtain from the OS the current default device and directory 
specification. 

Related Privileges: 

None. 

Parameters: 

devdir - Address of a 94 byte buffer to receive the default 
string. The string returned may be up to 93 
significant characters followed by a null character. 

Diagnostics : 

None. 
See Also: 

_chdir - Set default device and directory 

Assembler Calling Sequence: 

push devdir jaddress - default string 

jsr _getdir Jget default device and directory 

C function declaration: 

/* get default device and directory */ 
void /* no result */ 

__getdir (devdir) 

char devdir[94]; /* default string */ 

Fortran Subroutine Declaration: 

c ! get default device and directory 

subroutine getdir(devdir) 

character*94 devdir ! default string 

Pascal Procedure Declaration: 

procedure getdir( {** get default device and directory} 

var devdir : string[93] {** default string} 
) ; external ; 
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jGETONAM 

Get devicename. 

Description: 

The operating system maintains a device table for each mounted 
device. Given an index into the array of device tables, this SVC 
returns the corresponding devicename and device class. 

Use this call to obtain the devicenames of mounted devices. 

Related Privileges: 

None. 



Parameters: 



siteid 



index 
dname 



class 
status 



Diagnostics : 



The site ID of the system whose device table is being 

queried. A site ID of zero corresponds to the system 

on which the calling process is running. 

The index of which device is desired. An index of 

returns the name of the first device. 

Address of where to store the devicename. The devicename 

string will be null terminated. Hie string must be at 

least 32 characters long, allowing for up to 31 

significant characters plus a null. 

Address of a long word to receive the device class. 

Address of a long word to receive the result of 

the operation. 



errinvsiteid 
erridxrange 



(8) The specified site ID does not exist. 
(56) The table ends before the specified occurrence. 



See Also: 



_dismnt 

_flush 

_getdst 

_mount 

_setdst 



- Dismount a logical device 

- Flush I/O buffers to the device 

- Get device status 

- Mount a logical device 

- Set device status 
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Assembler Calling Sequence: 



push 


siteid 




push 


index 




push 


dname 




push 


class 




push 


status 




jsr 


_getdnam 




iction 


Declaration: 


long 






_getdnam ( siteid , 


index , dname 




long 


siteid; 




long 


index; 




char 


dname [94] ; 




long 


♦class; 



value - the system ID 
value - sequence number 
address - receives devicename 
address - receives device class 
address - result of the operation 
get devicename 



/* get devicename */ 
/* returns result of the operation */ 
class) 

/* the system ID */ 
/* sequence number */ 
/* receives devicename */ 
/* receives device class */ 



FOREMAN Subroutine Declaration: 



! get devicename 
subroutine _getdna( siteid , index f dname, class f status) 



integer*4 siteid 
integer*4 index 
character *94 dname 
integer*4 class 
integer *4 status 



Pascal Procedure Declaration: 



procedure _getdnam( 



siteid 
index 
var dname 
var class 
var status 
) ; external; 



longint; 
longint; 
string [93] ; 
longint; 
longint 



the system ID 
I sequence number 
! receives devicename 
! receives device class 
1 result of the operation 



{** get devicename) 

{** the system ID} 
{** sequence number} 
{** receives devicename} 
{** receives device class} 
{** result of operation} 
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Get device protection. 

Description: 

Retrieves the protection mask on a specified device. The 

protection mask determines the type of access granted to 
classes of users on the device. 

Protection can be retrieved on any class of device, independent 
of the privileges posessed by the calling process. 

Related Privileges: 

None. 



Parameters 
dname 



prot 



Address of a null terminated string containing the 
name of the device whose protection is sought. This 
string is translated automatically by the MCS to its 
logical equivalent. This string may contain up to 93 
significant characters followed by a null. If this 
string contains a file designation, the devicename 
portion of the file designation is used for this parameter. 
Address of a long word to receive the protection mask. 
The least significant 16 bit word of this long word 
is divided into 4 nibbles. Each nibble corresponds to 
a class of users. The bits within each nibble represent 
the type of access that class of user is granted for 
the device. If the bit is set (1) the access is granted. 

From the least to the most significant nibble the 
user classes are: 

Ownr - The device owner 

Grp - Processes with the same group id as the owner 
Pub - All other processes in the system 
Sys - Processes with system privilege 

Sys Pub Grp Ownr 
I , 1 1 1 

| DWRE | DWRE | DWRE | DWRE | 
j 1 

MSB LSB 

From the least to the most significant bit within the 
nibbles, the access privileges" are : 

E - Execute access 
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R - Read access 
W - Write access 
D - Delete access 

status - Address of a long word to receive the result of 
the operation. 

Diagnostics : 

errinvdevnam (130) The specified devicename is syntactically 

incorrect, 
errundevnam (131) The MCS does not recognize the devicename. 

Is the device mounted? 
errnoreadpriv (144) The process does not have Read Privilege for 

the file. 



See Also: 

_getfprt - Get file protection 
__setdprt - Set device protection 
__setfprt - Set file protection 

Assembler Calling Sequence: 



push 


dname 


push 
push 


prot 
status 


jsr 


_getdprt 


C Function 


Declaration: 



jaddress - device name 

jaddress - protection mask 
;address - result of the operation 

;get device protection 



long 

_getdprt (dname, prot) 

char dname [94] ; 

long *prot; 

Fortran Subroutine Declaration: 



/* get device protection */ 

/* returns result of the operation */ 

/* device name */ 

/* protection mask */ 



! get device protection 
subroutine getdpr(dname, prot, status) 
character*94 dname ! device name 



integer*4 prot 
integer*4 status 

Pascal Procedure Declaration: 

procedure _jgetdprt( 

dname : string[93]; 
var prot : longint ; 
var status : longint 



! protection mask 

! result of the operation 



{** get device protection} 

{** device name} 

{** protection mask} 

{** result of the operation} 
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); external; 
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_GETDST 
Get device status. 

Description: 

Given the device name of a currently mounted device, copies the 
device table and device status into user specified buffers. 

CAUTION: The format of the device table may change with each 
release. The current definition is included in each 
release in the file /sysiNCL.sys/DEVTDlSP.*. The record 
definition is named "devicetable", i.e. in your program 
you can declare a variable of type "devicetable." 

The device table for a device contains the information maintained 
about the device by the class handler. The device table is divided 
into two parts. The first part is device independent, and the second 
part is device class dependent. The device independent part is as 
follows: 

Length 
Name (bytes) Description 



dtnextlink 4 Pointer to the next device table 
dtbacklink 4 Pointer to the previous device table 
dtdevname 8 The user supplied device name 
dtclass 2 Contains the device class. Valid options are: 

Class Name Value Description 



dtclassttyspc Character device (ttyspc) 

dtclasstty 1 Character device (tty) 

dtclasstapespc 2 Tape device (tapespc) 

dtclasstape 3 Tape device (tape) 

dtclassdiskspc 4 Disk device (diskspc) 

dtclassdisk 5 Disk device (disk) 

dtclassnetspc 6 Network dev. (networkspc) 

dtclassnet 7 Network device (network) 

dtclasspipespc 8 Pipe device (pipespc) 

dtclasspipe 9 Pipe device (pipe) 

dtclasssyncspc 10 BSC device (syncspc) 

dtclasssync 11 BCS device (sync) 

dtclassquespc 12 Queue device (quespc) 

dtclassque 13 Queue device (que) 

dtclassnondevspc 14 Non-dev device (nondevspc) 

dtclassnondev 15 Non-dev device (nondev) 



GETDST-1 



Dictionary of WMCS System Calls 
_getdst 



dtrefcount 2 

dtdriveid 4 

dtallocpid 4 

dtsiteid 2 

dtseqnum 2 

dtdefuserid 2 



dtdefgroupid 



dtdefprotect 



dtclassptr 4 
dtdriverptr 4 
dtflags 2 



The number of files currently open on the 
device 

Internal drive ID 

The PID of the process that has this device 
allocated 

The site ID of this device 
The mount sequence number of this device. This 
will be unique for each device on the machine. 
The default user id for this device. This will 
be loaded into the DTUSERID variable every time 
the DTREFCOUNT variable goes to zero. 
The default group ID for this device. Ihis will 
be loaded into the DTCRGUPID variable every- 
time the DTREFCOUNT variable goes to zero. 
The default protection mask for this device. 
This will be loaded into the DTEROTECT 
variable everytime the DTREFCOUNT variable 
goes to zero. 

Address of the class handler for this device 
Address of the device driver for this device 
Device flags. This is a bit encoded word. 

Description 





dtflfcbflushmode 


4 


Current flush mode for 
disk fcbs 




dtf Ichf 1 ushmode 


5 


Current flush mode for 
disk cache 




dtflflushing 


6 


Device is currently 
being flushed 




dtflwriteprot 


7 


Device is write 
protected 




dtflcreatmode 


10 


Tape file is being 
created 




dtflfileopen 


11 


Tape file is open 




dtfleot 


12 


Tape is at physical 
end of tape 




dtfleof 


13 


Tape is at logical 
end of file 




dtflsessionestb 


15 


A session is currently 
established 


dtfcbptr 


4 Address of the file 


control block of the 




first open file 


on the device. A list 




head pointer. (Used for disks only) 


dtblksz 


2 Block size for the device 


dtuserid 


2 Owner ID portion 


of 


the UIC. Corresponds 




to the owner of 


the device. 


dtgroupid 


2 Group ID portion 


of 


the UIC. Corresponds 




to the owner of 


the device. 
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dtprotect 2 
dtmntmstime 4 
dtmntlstime 4 



dtidfield 2 
dtidtag $5555 



The device protection flags. Uses the 
same format at the file protection flags. 
The most significant 32 bits (year and day) 
of the date and time the device was mounted 
The least significant 32 bits (hour, minute, 
second and tick) of the date and time the 
device was mounted 
Table identifier flag 
Table ID value for this table 



For TTy, PIPE, SYNC, and NCNDEV class devices, the second part of the 
table is defined as follows: 



Name 



Length 

(bytes) Description 



dttyreadacc 
dttyreadlock 
dttywriteacc 
dttywritelock 



dttywriteqh 

dttyreadqh 

dttydriveid 

dttyboardid 

dttytypeid 



1 ttie read access count (the number of 

times this device has been opened for 

read access) 
1 The read lock count (the number of 

times this device has been opened with 

read lock) 
1 The write access count (the number of 

times this device has been opened for 

write access) 

1 The write lock count (the number of 
times this device has been opened with 
write lock) 

4 The write queue header 
4 The read queue header 

2 Contains drive table index 
2 Contains board table index 
2 Contains type ID of board 



For TAPE class devices, the second part of the table is defined as 
follows: 



Name 



Length 

(bytes) Description 



dttpreadahead 
dttpfilseqno 

dttpcachesz 



2 " Read ahead flag 

4 Sequence number of currently open file or next 

file to be opened. 
2 Number of elements in tape cache 
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dttpcacheadr 
dttpskpcache 



dttpnextblk 
dttpreadpos 



4 Address of cache header 

4 Address of special cache header for 

non-buffered commands, i.e., skip, get or set 

status, write file mark 
4 Next logical block number in the currently 

open file 
2 Actual block number to be read next physically 



For DISK class devices, the second part of the table is 
follows: 



defined as 



Name 



dtdkflags 



dtdksecshfcnt 
dtdkdef alloc 
dtdksecalloc 
dtdkchreadmin 
dtdkmaxuserch 



dtdkszmaxch 



Length 

(bytes) Description 



dtdkcachecolsz 


2 


dtdkcachesze 


2 


dtdkchaddr 


4 


dtdkbmpos 


4 


dtdkfcbbmpos 


4 


dtdkfcbptr 


4 


dtdkdirptr 


4 


dtdkfcbbitptr 


4 


dtdkbitptr 


4 


dtdkalocsecqh 


4 


dtdkalocfcbqh 


4 



Disk class flags. This is a bit encoded word. 
Bit Name Bit # Description 



dtdkflautoflush 

dtdkflreadahead 1 
dtdkflforceowrite 2 



If set do auto 

flushing 

If set do readahead 

If set do forced 

writes on all writes 



The sector shift count 

The initial file allocation 

The secondary file allocation 

Non-modified cache minimum size 

Number of cache elements (minus 1) that 

can be consumed in a single request 

to the OS 

Size of stack area in bytes used to 

hold the addresses of used cache elements 

( (devcldsmaxcache+2) *4) 

The number of columns in the cache 

The number of cache sectors 

Address of disk cache column table 

Bitmap file's next allocation location 

Fcbbitmap file's next allocation location 

Address of fcb for FCB.sys 

Address of fcb for RCXMDIR.DIR 

Address of fcb for FCBBITMAP. SYS 

Address of fcb for BITMAP. SYS 

Allocate disk queue head 

Allocate fcb queue head 
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For NETWORK class devices, the second part of the table is defined as 
follows: 



Name 



Length 

(bytes) Description 



dtnkreadacc 

dtnkreadlock 

dtnkwriteacc 

dtnkwritelock 

dtnkflags 



dtnkwriteqh 
dtnkreadqh 
dtnkhwrite 
dtnkhuninit 



For QUEUE class devices, 
follows: 



1 The read access count (the number of 

times this device has been opened for 

read access) 
1 The read lock count (the number of 

times this device has been opened with 

read lock) 
1 The write access count (the number of 

times this device has been opened for 

write access) 

1 The write lock count (the number of 
times this device has been opened with 
write lock) 

2 Network class flags. This is a bit encoded 
word. 

Bit Name Bit # Description 
dtnkflvcdriver If set, this is a 

virtual circuit driver 
4 The write access queue header 
4 The read access queue header 
4 Pointer to network layer write routine 
4 Pointer to network layer uninit routine 

the second part of the table is defined as 



Name 



Length 

(bytes) Description 



dtqucbptr 

dtqufhptr 
dtquwriteoper 



Contains the address of control block page 

which is the communication block between the 

QUEUE class handler and the queue manager 

process 

Contains the address of the queue control 

file header page 

Contains how many write operations have 

been performed on the QUEUE 
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dtquflags 



QUEUE class flags. Bit 
Bit Name Bit # 
dtqufldefcrp 



dtquflqmres 



dtquflqmnodie 



dtquflclosed 



dtquflhalted 



dtquflclean 



encoded word. 
Description 
A default create 
process record is 
defined. This means a 
user can redirect I/O 
directly to the QUEUE. 
The queue manager 
process is to 
remain resident at 
all times 

In critical code and 
the queue manager 
process cannot die 
Hie queue is marked 
as closed. No new 
entries may be queued. 
The queue is marked as 
halted. No pending 
entries will be 
executed. 

There are no entries 
in the queue control 
files 



The device status is a device class dependent 128 byte table. It is 
maintained by the device driver for each device. 

NOTE: The device status table may change with each release of 
the operating system. The current definition is included 
in each release in the file named: /sysiNCL.SYS/ 
DSTATDISP.*. The name of the record included in that file 
is "devicestatus, " i.e. in your program you can declare a 
variable whose type is "devicestatus." 
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The device status table is divided into two parts. The first half is 
device independent and is composed of the following fields: 



Name 



dsclassid 



Length 

(bytes) Description 



dsdriverid 
dsblksz 

dsharderr 

dssofterr 

dsreadoper 

dswriteoper 

dsmaxnumdev 

dscurnumdev 

dsnumtoretry 

dserror reason 

dsreserved 
dsnexttabl ept r 



The device class. Valid classes are: 
(Note that these names are defined in 
the devtdisp.* files) 
Class Name Value Description 



dtclassttyspc 

dtclasstty 

dtclasstapespc 

dtclasstape 

dtclassdiskspc 

dtclassdisk 

dtclassnetspc 

dtclassnet 

dtclasspipespc 

dtclasspipe 

dtclasssyncspc 

dtclasssync 

dtclassquespc 

dtclassque 

dtclassnondevspc 14 

dtclassnondev 15 





1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

11 

12 

13 



32 
4 



Character device (ttyspc) 
Character device (tty) 
Tape device (tapespc) 
Tape device (tape) 
Disk device (diskspc) 
Disk device (disk) 
Network dev. (networkspc) 
Network device (network) 
Pipe device (pipespc) 
Pipe device (pipe) 
BSC device (syncspc) 
BCS device (sync) 
Queue device (quespc) 
Queue device (que) 
Non-dev device (nondevspc) 
Non-dev device (nondev) 
The unique id number for this device driver 
The block size of the device (e.g. sector 
size) 

The hard error count for the device 
The soft error count for the device 
The number of read operations on this device 
The number of write operations on this device 
Maximum # of devices this driver can handle 
Number of devices currently mounted using this 
device driver 

Number of times to retry before reporting a 
hard error 

This contains the hardware error code for the 
last error received on this device 
Reserved 
Address of next device status table 



GETDST-7 



Dictionary of WMCS System Calls 
_getdst 



The second half of the device status table is device class dependent 
For TAPE class devices the second part is defined as follows: 



Name 



dstpstatus 



dstpflagsl 



dstpspeed 



dstpdensity 



Length 










(bytes) 


Description 








2 


Tape device status. 


A bit encoded word. 




Bit name 


bit 


# 


Description 




dstpready 







Set if device ready 




dstpintpend 


1 




Set if interrupt 
pending 




dstprewinding 


2 




Set if tape rewinding 




dstpbotdetect 


3 




Set if device is at 
physical BOT 




dstpeotdetect 


4 




Set if device is at 
physical BOT 




dstpwriteprot 


5 




Set if tape is write 
protected 


2 


Tape status information 


l. A bit encoded word. 




Bit name 


bit 


# 


Description 




dstpdoraw 







0=Read after write 

disabled 

l=Read after write 

enabled 




dstperrintenb 


1 




0=Error interrupts are 

enabled 

l=Error interrupts are 

disabled 


1 


Tape speed. Values 


are 


»• 






- 


Reserved 




dstpspeedl2ips 


1 - 


12 


ips 




dstpspeed25 ips 


2 - 


25 


ips 




dstpspeed30ips 


3 - 


30 


ips 




dstpspeed50 ips 


4 - 


50 


ips 




dstpspeed90 ips 


5 - 


90 


ips 




dstpspeedlOO ips 


6 - 


IOC 


1 ips 




dstpspeedl25ips 


7 - 


12£ 


> ips 


1 


Tape density. ' 


Values are: 






- 


Reserved 




dstpdens800bpi 


1 - 


80C 


) bpi 




dstpdensl6 OObpi 


2 - 


1600 bpi 




dstpdens3200bpi 


3 - 


3200 bpi 




dstpdens6250bpi 


4 - 


6250 bpi 




dstpdens6400bpi 


5 - 


6400 bpi 
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dstpiopbcnt 2 

dstpcachesz 2 

dstpreserved 46 

dstpuserfield 8 



Number of IOFBs allocated to device 

Number of cache elements allocated to device 

Reserved 

User defined status 



For DISK class devices the second half 
defined as follows: 



of the device status table is 



Name 



dsdkintfac 

dsdkiopbcnt 

dsdknumbsect 

dsdksectrack 

dsdkheads 

dsdkcylinders 

dsdkflagsl 



dsdkcurcyl 

dsdkcachesz 

dsdkentryname 

dsdkreserved 
dsdkuserfield 



Length 

(bytes) Description 



2 

2 

16 

20 
8 



Disk interleave factor 

Number of IOFB's allocated to the drive 

The number of sectors on the volume 

The number of sectors on a track 

The number of heads on the device 

The number of cylinders on the volume 

Disk status information. A bit encoded word. 

Bit Name Bit # Description 



dsdkdensityl 
dsdkdensity2 1 
dsdkdenssignle 
dsdkdensdouble 
dsdkdensquad 
dsdkdensreserve 
dsdkdoraw 



Device density 



00 - Single density 

01 - Double density 

10 - Quad density 

11 - Reserved 

3 If set, do Read after 
write verify 

4 If set, Device write 
protected 

15 Current seek direction 
- Increasing 
cylinder numbers 
$8000 - Decreasing 
cylinder numbers 
Current cylinder position 
Number of sectors in the disk cache 
A null terminated string containg the name of 
this type of drive 
Reserved 
User Defined status 



dsdkwriteprot 

dsdkseekdir 
dsdkseekincr 

dsdkseekdecr 
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For m? class devices 
defined as follows: 



the second half of the device status table is 



Name 



Length 

(bytes) Description 



dstymoderegl 



Uart mode register 1. 
encoded as follows: 
Bit Name Bit # 
dstymrlbaudfacl 
dstymrlbaudfac2 1 
dstymrlsyncl 

dstymrlasyncl 

dstymrlasyncl6 

dstymrlasync64 

dstymrlcharlenl 2 
dstymrlcharlen2 3 

dstymrldw5bit 

dstymrldw6bit 

dstymrl6V7bit 

dstymrl6V8bit 
dstymrlparityctrl 4 

dstymrlpardis 

dstymrlparenb 
dstymrlparitytype 5 

dstymrlparodd 

dstymrlparevn 
dstymrlstopbitsl 6 

dstymrlstopbits2 7 

dstymrlbinv 

dstymrlsbl 

dstymrlsbl5 

dstymrlsb2 
dstymrltransctrl 6 

dstymrlnormal 

dstymrltrans 
dstymrlnumsync 7 

dstymrlsyncdouble 

dstymrlsyncsingle 



This byte is bit 

Description 
Baud factor 



00 - 



01 - 



1 x clock 



1 x clock 



sync 

rate 

async 

rate 

async 16 x clock 

rate 

async 64 x clock 



10 - 

11 - 

rate 
Character length 
definition 
00-5 data bits 
01-6 data bits 
10-7 data bits 
11-8 data bits 
Parity control 

- disable parity 

1 - enable parity 
Parity type 

- odd parity 

1 - even parity 
Async mode # of stop 
bits 

Async mode # of stop 

bits 

00 - invalid 

01-1 stop bit 

10 - 1.5 stop bits 

11-2 stop bits 

Sync mode transparent 

- normal 

1 - transparent 
Sync mode # of syncs 

- double sync 

1 - single sync 
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dstymodereg2 



dstycmdreg 



Uart mode register 2. 
encoded as follows: 
Bit Name Bit # 
dstymr2baudrtl 
dstymr2baudrt2 1 
dstymr2baudrt3 2 
dstymr2baudrt4 3 
dstymr2baud50 
dstymr2baud75 
dstymr2baudll0 
dstymr2baudl345 
dstymr2baudl50 
dstymr2baud300 
dstymr2baud600 
dstymr2baudl200 
dstymr2baudl800 
dstymr2baud2000 
dstymr2baud2400 
dstymr2baud3600 
dstymr2baud4800 
dstymr2baud7200 
dstymr2baud9600 
dstymr2baudl9200 
dstymr2recvclock 4 
dstymr2 r ecextcl k 
dstymr2recintclk 
dstymr2transclock 5 
dstymr2trnextclk 
dstymr2trnintclk 

6-7 
Uart command register. 
Bit Name Bit # 
dstycrtransctrl 
dstycrtcdis 

dstycrtcenb 

dstycrdtr 1 

dstycrdtrhigh 

dstycrdtrlow 
dstycrrecvcrtl 2 

dstycrrcdis 

dstycrrcenb 
dstycrforcebrk 3 

dstycrbrknorm 

dstycrbrkforce 



This byte is bit 

Description 
The baud rate 
Baud rate continued 
Baud rate continued 
Baud rate continued 

0000 - 50 baud 

0001 - 75 baud 

0010 - 110 baud 

0011 - 134.5 baud 

0100 - 150 baud 

0101 - 300 baud 

0110 - 600 baud 

0111 - 1200 baud 

1000 - 1800 baud 

1001 - 2000 baud 

1010 - 2400 baud 

1011 - 3600 baud 

1100 - 4800 baud 

1101 - 7200 baud 

1110 - 9600 baud 

1111 - 19200 baud 
Receiver clock 

- External clock 

1 - Internal clock 
Transmitter clock 

- External clock 

1 - Internal clock 
Reserved 

Bit encoded. 
Description 
Transmitter control 

- Disable 

transmitter 

1 - Enable 

transmitter 
Data terminal ready 

- DTR high 

1 - DTR low 
Receiver control 

- Disable receiver 

1 - Enable receiver 
Async force break 

- normal 

1 - force break 
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dstytermtype 



dstycrsenddle 
dstycrdLenorm 
dstycrdlesend 

dstycr reseter ror 
dstycrnoreset 
dstycrreseterr 

dstycr rts 
dstycrrtshigh 
dstycrrtslow 

dstycropermodel 

dstycropermode2 



Sync send DLE 

- normal 

1 - send DLE 
Reset error 

- normal 

1 - reset error 
Request to send 

- RES high 

1 - RES low 
Operating mode 
Operating mode 
continued 



dstycromnormal 00 

dstycromautoecho 01 

dstycromstripdle 01 

dstycromlocallp 10 

dstycromremotelp 11 
Terminal type definition, 
values for each type of terminal. 
Value Name Value Description 



Normal operation 
Async autoecho 
Sync strip ELE 
Local loop back 
Remote loop back 
This byte contains 



dstystatreg 



0-15 


User defined types 


16-246 


Reserved 


dstywit 247 


WIT terminal 


dstyhydra 248 


Hydra terminal 


dstyvtlOO 250 


VT-100 terminal 


dstyvt52 251 


VT-52 terminal 


dstyt7000 252 


T-7Q00 terminal 


dstymg8000 253 


M3-8000 terminal 


dstytvi912c 254 


TVI 912 C terminal 


dstyvisual200 255 


Visual 200 terminal 


Dart status register. 


Bit encoded. 


Bit Name Bit # 


Description 



dstysrtransrdy 

dstysrtranfull 
dstysrtranempty 

dstysrrecvrcfy 1 
dstysrrecvempty 
dsty sr r ecvfull 

dstysrdschg 2 
dstysrdsrnormal 
dstysrdsrchange 



Transmitter buffer 
ready 

- Transmitter full 

1 - Transmitter empty 
Receiver buffer ready 

- Receiver empty 

1 - Receiver full 
DSR or DO) change 

- Normal 

1 - DSR or DCD change 
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dstypacketterm 



dstysrparityerr 3 
dstysrparnormal 
dstysrparerror 



dstysroverrunerr 4 
dstysrovernormal 
dstysrovererror 

dstysrframingerr 5 
dstysrframnormal 
dstysrframerror 



dstysrdcddetect 6 

dstysrdcdhigh 

dstysrdcdlow 
dstysrdsrdetect 7 

dstysrdsrhigh 

dstysrdsrlow 
Holds code for packet 
Value Name Value 



Parity error 

- Normal 

1 - Async parity 

error. Sync 
parity error 
or DLE received 
Overrun error 

- Normal 

1 - Overrun error 
Framing error 

- Normal 

1 - Async framing 

error. Sync SYN 
char 
DCD Detect 

- DCD high 

1 - DCD low 
DSR Detect 

- DSR high 

1 - DSR low 
termination characters 

Description 



dstyflagsl 



dstyptnoterm 

dstyptallterm 
dstyptcrterm 

Terminal status 
Bit Name 
dstycontrolc 

dstyxonxoff 

dstycontrolx 

dstycontrolz 

dstycontrolo 

dstytabmap 

dstymask8bit 



Do not terminate 
packet on any control 
characters 

1 Terminate packets on 
all control characters 

2 Terminate packet on 
carriage return <CR> 
character 

information. Bit encoded, 
bit # Description 

Control C enable 
(0 = enabled) 

1 xon xoff enable 
(0 = enabled) 

2 Control X enable 
(0 = enabled) 

3 Control Z enable 
(0 = enabled) 

4 Control enable 
(0 = enabled) 

5 Tab map enable 
(1 = enabled) 

6 Mask 8th bit enable 
(0 = enabled) 
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dstyinputcnt 2 

dstyoutptcnt 2 

dstycolumnpos 2 

dstyinbufsz 2 

dstyoutbufsz 2 

dstywidth 2 

dstylength 2 

dstysubreadoper 4 

dstysufcwriteoper 4 

dstyreserved 26 

dstyuserfield 8 



dstycontrolu 7 
dstybroadcast 8 



dstyhandshakel 

dstyhandshake2 

dstyhsbell 



9 
10 



Control U enable 
(0 = enabled) 
Broadcast enable 
(0 = enabled) 
Handshaking type 

00 - No handshake , 
send bell 

01 - Software 
handshake 

10 - Hardware 
handshake 

11 - No handshake, no 
bell 

Full/half duplex 
(0 = full duplex) 
Modem control enable 
(1 = enabled) 
Auto baud enable 
(1 = enabled) 
Remote enable 
(1 = enabled) 

Count of characters in input interrupt buffer 

Count of characters in output interrupt buffer 

Current column position 

Input buffer size in bytes 

Output buffer size in bytes 

The width of the given terminal screen 

The length of the given terminal screen 

Number of sub-read operations 

Number of sub-write operations 

Reserved 

User defined status 



dstyhssoft 

dstyhshard 

dstyhsnone 
dstyduplex 11 
dstymodemctrl 12 
dstyautobaud 13 
dsty remote 14 



For PIPE class devices the second part 
defined as follows: 



of the device status table is 



Name 



Length 

(bytes) Description 



dsppreaderpid 

dsppwriterpid 

dspppipeid 

dsppbuffersz 

dsppbuffercnt 



4 Process ID of pending reader 

4 Process ID of pending writer 

4 The pipe's ID 

2 The buffer size in bytes 

2 Number of characters in the pipe buffer 
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dsppreadque 4 

dsppwriteque 4 

dsppreserved 32 

dsppuserfield 8 



Address of read queue 

Address of write queue 

Reserved 

User defined status 



For SYNC class devices the second part 
defined as follows: 



of the device status table is 



Name 



Length 

(bytes) Description 



dssymoderegl 
dssymodereg2 
dssycmdreg 
dssytermtype 



dssystatreg 

dssynumbsync 
dssyflagsl 



Mode register 1 of the uart (See DSTYM0DEREG1 

for bit definitions) 

Mode register 2 of the uart (See DSTYM0DERBG2 

for bit definitions) 

Command register of the uart (See DSTyCMDRBS 

for bit definitions) 

Terminal type definition. A binary value. 

Value Name Value Description 



dssyifcm3741 249 

dssyifcm2968 250 

dssyibm2770 251 

dssyibm3276 252 

dssyibm3275 253 

dssyibm2780 254 

dssyibm3780 255 

Status register of uart 

for bit definitions) 

Number of sync characters to write 

Device Status flags. Bit encoded. 

Bit Name Bit # Description 



IBM 3741 terminal 
IBM 2968 terminal 
IBM 2770 terminal 
IBM 3276 terminal 
IBM 3275 terminal 
IBM 2780 RJE 
IBM 3780 RJE 
(See DSTySTABREG 



dssymultipnt 

dssyebcdic 

dssycrcccitt 

dssylrc 

dssyasctoebcw 



0=point to point 

l=multipoint 

0=ascii line 

l=ebcdic line 

0=crc-16 

l=crc-ccitt 

0=crc (on above types) 

l=lrc 

0=no translate on 

write 

l=translate ascii to 

ebcdic on write 
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cissy ebctoascr 



dssyinputcnt 2 

dssyoutputcnt 2 

dssyinbufsz 2 

dssyoutbufsz 2 

dssyprevrderr 4 

dssyprevwrerr 4 

dssyprevrdtype 1 



dssynumbtrpad 1 

dssyrecsize 2 

dssy reserved 28 

dssyuserfield 8 



dssytranstbl2 



5 0=no translate on read 
l=translate ebcdic to 
ascii on read 

6 0=use translate 
table 1 

l=use translate table 

2 
Number of characters in input interrupt 
buffer 

Number of characters in output interrupt 
buffer 

Input buffer size in bytes 
Output buffer size in bytes 
Error from previous un-verif ied read 
Error from previous no-wait write 
Type of previous read 
dssynontran - Non-transparent read 
dssytran - 1 Transparent read 
The number of trailing pads to write 
Used in transparent mode with ITBs 
Reserved 
User defined status 



For NETWORK class devices the second 
is defined as follows: 



part of the device status table 





Length 




Name 


(bytes) 
2 


Description 


dsnkflags 


Device status flags. Bit encoded. 






Bit Name Bit # Description 






dsnkfcyte 0=datagram mode 






l=byte mode 






dsnkmodemctrl 1 0=not enabled 






l^modem Ctrl enabled 


dsnkwindowsiz e 


1 


Window size the circuit will use 


dsnkreserved 


53 


Reserved 


dsnkuserfield 


8 


User defined status 
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For NONDEV class devices the second part of the 
is defined as follows: 



device status table 



Name 



Length 

(bytes) Description 



dsnduserfield 



64 



Reserved 



For QUEUE class devices the second part of the device status table is 
defined as follows: 



Name 



Length 

(bytes) Description 



dsquassocdev 
dsqusenddev 

dsquformname 
dsqunumexec 
dsqucurnumexec 
dsquflags 



9 
9 

10 
2 
2 
2 



dsqulength 

dsquwidth 

dsqunextentry 



A null terminated string containing the name 

of the physical printer device 

A null terminated string containing the name 

of the physical device that control messages 

are to be sent to 

A null terminated string containing the 

current form name 

Maximum number of entries that can execute 

concurrently 

The number of entries that are 

currently active 

Device Status flags. Bit encoded. 

Bit Name Bit # Description 



dsquflupdating 



dsquflqmstay 



dsquflnorestart 



) If set, currently 

updating queue control 
file 
L If set, the queue 

manager process will 
remain running even 
when queue is empty 
I If set, when the queue 

is mounted it does not 
restart the jobs in 
the queue 
This holds the length of the forms of the 
printer associated with this queue 
This holds the width of the forms of the 
printer associated with this queue 
Ihe entry number of the next entry to 
be enqued 
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dsqutype 



The type of queue this is. The 

values are: 

Value Name Value Description 



dsqubaseprior 

dsqureserved 
dsquuserfield 

Related Privileges; 

None. 



20 
8 



dsqutpprint 1 Print type queue 

dsqutpjob 2 Job entry type queue 

The priority that entries will be queued at 

if they specify the default priority 

Reserved 

User defined status 



Parameters: 



dname 



dtable 
ldtab 

dstat 
status 

Diagnostics : 



Address of a null terminated string containing 

the name of the device. This string is translated 

automatically by the MCS into its logical equivalent. 

This string may contain up to 93 significant 

characters followed by a null. If this string contains 

a file designation the devicename portion of the 

file designation is used. 

Address of a buffer to receive the device table. This 

table must be word aligned. 

Length of the device table. Up to this many bytes 

of the device table will be transferred to the user 

buffer. 

Address of a 128 byte buffer to receive the device 

status. 

Address of a long word to receive the result of 

the operation. 



errinvdevnam (130) The specified devicename is syntactically 

incorrect, 
errundevnam (131) The MCS does not recognize the devicename. 

Is the device mounted? 
errnoreadpriv (144) The process does not have Read Privilege 

for the file. 
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See Also: 

_dismnt 

_getdnam 

_giodst 

__mount 

_jsetdst 

_siodst 



- Dismount a logical device 

- Get device name 

- Get device status with lun 

- Mount a logical device 

- Set device status 

- Set device status with lun 



Assembler Calling Sequence: 

%%sys$disk/sysincl . sys/devtdisp. asm 

%%sys$disk/sysincl . sys/dstatdisp. asm 

push dname ; address - device name 

push dtable /address - device table 

push ldtab ; value - length of device table 

push dstat ; address - device status 

push status ;address - result of the operation 

jsr _getdst ;get device status 

C Function Declaration: 

♦include "sy s$disk/sysincl . sys/devtdisp- h" 
♦include n sys$disk/sysincl . sys/dstatdisp. h" 

/* get device status */ 
long 
_getdst (dname , dtable, ldtab, 

char dname [943 ; 

devicetable *dtable; 

long ldtab; 

devicestatus *dstat; 

FORTRAN Subroutine Declaration: 



/* returns result of the operation */ 
dstat) 
/* device name */ 
/* device table */ 
/* length of device table */ 
/* device status */ 



I get device status 
subroutine __getdst (dname/ dtable/ ldtab , dstat, status) 
character *94 dname ! device name 
character* (*) dtable I device table 
integer*4 ldtab ! length of device table 
character* (*) dstat I device status 
integer*4 status I result of the operation 
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Pascal Procedure Declaration: 

%%sys$disk/sysincl . sys/devtdisp. pas 
%%sys$disk/sysincl . sys/dstatdisp. pas 

procedure __getdst( {** get device status) 

dname 

dtable 

ldtab 

dstat 
var status 
) ; external ; 



string [93]; {** device name) 
*array_of_char;{** device table) 
longint; {** length of device table) 
~array_of__char;{** device status) 
longint {** result of the operation) 
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Get device UIC. 

Description: 

Given a device name, returns the user identification code (uic) 
which is composed of an owner id and a group id. 

This system call is valid for any class of device. 
Related Privileges: 

None. 
Parameters : 

dname - Address of a null terminated string containing the 

name of the device whose uic is requested. This string 
will be translated automatically by the MCS to its 
logical equivalent. This string may contain up to 
93 valid characters followed by a null byte. If the 
string contains a file designation, the devicename 
part of the file designation is used for this parameter. 

uic - Address of a long word to receive the user identification 
code. This long word is divided into two fields. 
The most significant 16 bits constitute the owner 
id number. The least significant 16 bits constitute 
the group id number (identifying the group to which 
the user belongs). 

status - Address of a long word to receive the result of 
the operation. 



Diagnostics: 

errinvdevnam 
errundevnam 

See Also: 



(130) The specified devicename is syntactically 
incorrect. 

(131) The MCS does not recognize the devicename. 
Is the device mounted? 



_getfuic - Get file uic 

__getuic - Get process uic 
_setduic - Set device uic 
_setfuic - Set file uic 

setuic - Set process uic 
Assembler Calling Sequence: 
push dname 



jaddress - device name 
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push uic 
push status 
jsr _getduic 

C Function Declaration: 



long 
_getduic(dname, uic) 

char dname [94] ; 
long *uic; 

Fortran Subroutine Declaration 



;address - user id code 

; address - result of the operation 

;get device uic 



/* get device uic */ 

/* returns result of the operation */ 



/* device name */ 
/* user id code */ 



! get device uic 
subroutine getdui(dname, uic, status) 



character*94 dname 
integer*4 uic 
integer*4 status 

Pascal Procedure Declaration: 



! device name 

! user id code 

! result of the operation 



procedure _jgetduic( 

dname : string [93]; 

var uic : longint; 

var status : longint 
) ; external ; 



{** get device uic} 

{** device name} 

{** user id code} 

{** result of the operation} 
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_GETEVNT 

Read event flags. 

Description: 

Read the event flags of any desired process. The event 
flags to be read are specified by a mask. 

Related Privileges: 

None - Allows reading event flags of any process with 

the same owner id and group id (uic) as the ^calling 
process. 

group - Allows reading event flags of any process with 
the same group id as the calling process. 

world - Allows reading event flags of any process. 

Parameters : 

pid - process id of the process whose event flags 

are to be read, 
efmask - Event flag mask specifying which of the event 

flags are to be read. Those bits that correspond 

to l's in the mask will be read. The other bits 

will be set to zero, 
eflags - Address of a long word to receive the event flags 

which were read, 
status - Address of a long word to receive the result of 

the operation. 

Diagnostics: 

errinsufpriv (1) The process lacks the privileges required to 

perform the operation, 
errprcsnotfnd (2) The specified process is not in the system 

process table. 

See Also: 

__andevnt - Wait for AND of event flags 
_clrevnt - Clear event flags 

orevnt - Wait for OR of event flags 
— setevnt - Set event flags 



Assembler Calling Sequence: 



push 


pid 


push 


efmask 


push 


eflags 


push 


status 



;value - process id 

;value- - event flag mask 

jaddress - resulting event flags 

;address - result of the operation 
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jsr _getevnt 
C function declaration: 



long 

__getevnt(pid, efmask, eflags) 

long pid; 

long efmask; 

long *eflags; 

Fortran Subroutine Declaration: 



;read event flags 



/* read event flags */ 

/* returns result of the operation */ 

/* process id */ 

/* event flag mask */ 

/* resulting event flags */ 



! read event flags 

! returns result of the operation 
integer*A function getevn(pid, efmask, eflags) 
integer*4 pid ! process id 
integer*4 efmask ! event flag mask 
integer*4 eflags ! resulting event flags 



Pascal Procedure Declaration: 



procedure getevnt ( 



pid 

efmask 
var eflags 
var status 
); external; 



longint ; 
longint ; 
longint; 
longint 



{** read event flags} 

{** process id} 

{** event flag mask} 

{** resulting event flags} 

{** result of the operation} 
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Get the address of the current exit handler. 

Description: 

Call this routine to get the address of the currently defined exit 
handler. (See JSEEEXIT for a description of exit handlers.) Returns 
zero if no exit handler is defined. 

Related Privileges: 

None. 
Parameters: 

adr 
Diagnostics: 

None. 

See Also: 

_ermo - Receive process abort reason 
_exitrtn - Define a returnable exit handler 
_exproc - Terminate the specified process 
_setexit - Set exit handler 



- Address to store exit handler address. 



Assembler Calling Sequence: 



push 
jsr 



adr 
_getexit 



C Function Declaration: 

void 
_getexit(adr) 

long *adr; 

F0R3RAN Subroutine Declaration: 

c 



; address - address of exit handler 
;get the exit handler address 



/* get exit handler address */ 
/* no result */ 

/* Returned address of exit handler */ 



1 get exit handler address 
subroutine _getexi(adr) 

integer*4 adr I Returned address of exit handler 
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Pascal Procedure Declaration: 



procedure _getexit( {** get exit handler address) 

var adr : longint {** Returned address of exit handler} 
) ; external ; 
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Get file control block. 

Description: 

Given the logical unit number dun) of a file successfully opened for 
read and/or write access by the calling process, the file control 
block (fcb) for that file is copied to the process's buffer. 

CAUTION: The format of the file control block may change with 
each release. The current definition is included in 
each release in the file /SYSINCL.SYS/FCBDISP.*. The 
name of the fcb record is "fcbtype", i.e. in your 
program you can declare a variable whose type is 
"fcbtype". 

There are several variations on the format of file control blocks , 
depending on the class of device which contains the file. Disk files 
contain "root" fcbs and "continuation" fcbs. Tape files have "tape" 
fcbs. All other files have "tty" fcbs. 

On tapes , the zeroeth fcb is the file header. It does not contain 
accurate file size information. The first continuation fcb on a tape 
is the file trailer. It is the same as the file header except that 
it contains correct file size information. If the first continuation 
fcb of a tape file is requested , the tape is positioned at the 
logical end of the file. 

The format of the first 14 bytes of the fcb record is the same for 
all types of fcb's. Ihe format of this common type is: 

Length 
Name (bytes) Description 



fcbnum 4 fcb number for this fcb. The record 

number of this record within the fcb file. 

For tty fcbs, the value of this field 

is zero, 
fcbseqnum 2 fcb sequence number. This number is 

unique for each usage of this fcb. 

For tty fcbs, the value of this field 

is zero. 
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fcbcntfcbnum 

fcbcntseqnum 
fcbusageid 



fcb number of continuation fcb. Hie 

record number of the next fcb for this 

same file. For tape and tty fcbs, the 

value of this field is zero. 

Sequence number of the continuation fcb. 

For tape and tty fcbs, the value of this 

field is zero. 

Usage id field. Hie type of fcb. Values 

are: 

Name Value Description 



fcbunalloc 



fcbextusecnt 



This fcb is unused. The 
data in this record is 
invalid. 

1 This record contains a 
root fcb. 

2 This record contains a 
continuation fcb. 

Number of extent fields in use within 
this fcb. 



fcballocroot 



fcballoccont 



The format of the last 242 bytes of the fcb is different for 
"primary " fcbs as opposed to "continuation" fcbs. For primary fcbs 
(disk, tape and tty) the format is as follows: 



fcbfiletype 



File type. For tty files, it is 

always set to zero (a data file) . Valid 

file types are: 

Name Value Description 



fcbftdata 

fcbftdir 1 

fcbftimage 2 

fcbftksamdata 3 

fcbftksamkey 4 

fcbftllimage 5 

fcbftarchcont 6 

fcbftencrypt 7 

fcbftsystem 8 

fcbftarchive 9 



Data file 

Directory file 

Image file 

KSAM data type file 

KSAM key type file 

11 type image file 

Archive continuation file 

Encrypted file 

System file 



fcbfilename 



Archive file 
10-255 Reserved 

256-65535 User defined file types 
File name. For disk and tape files it 
contains the filename portion of the file 
designation. For tty files it contains 
the devicename. 



GETPCB-2 



Dictionary of WMCS System Calls 

_getfcb 



fcbfileext 

fcbfilevers 

fcbdirfcbnum 

fcbdirseqnum 

fcbrecordsz 

fcbuserid 

fcbgroupid 

fcbprotect 

fcbcreatemstim 
f cbcr eatel st im 



fcbmodmstini 



fcbmodlstim 



fcbreserved 
fcbphysicalsz 

fcblogicalsz 

fcbfileid 



3 File extension. For tty fcbs this field 
is set to zero. 

2 File version number. For tty fcbs this field 
is set to zero. 

4 Directory fcb number. The fcb number of 
the directory file containing this file. 
For tape and tty fcbs it contains zero. 

2 Directory sequence number. The sequence 
number of the directory file containing 
this file. For tty fcbs this field contains 
zero. 

2 Default record size. For tty fcbs this 
field is set to 1. 

2 CX/ner id of the files owner. 

2 Group id of the files owner. 

2 File protection field. For tty fcbs it 
contains the device protection. 

4 The most significant 32 bits of the file 
creation date in system time format (year 
and day) . For tty fcbs, it contains 
the year and day that the device was mounted. 

4 The least significant 32 bits of the file 
creation date in system time format (hour, 
minute, ...). For tty fcbs, it contains 
the hour, minute, ... that the device was 
mounted. 

4 The most significant 32 bits of the date 
the file was last modified (year and day) . 
For tty fcbs, it contains the year and day 
that the device was mounted. 

4 The least significant 32 bits of the date 
the file was last modified (hour, minute, 
second, tick) . For tty fcbs, it contains 
the hour, minute, ... that the device was 
mounted. 

4 Reserved space 

4 The physical size of the file in bytes. 
For tty fcbs, it is set to zero. 

4 The logical size of the file in bytes. 
For tty fcbs, it is set to zero. 

2 File id of the file. For tty fcbs, it is 
set to zero. 
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fcbrootextblk 



180 



file extent fields. There are 30 extent 
fields in a primary fcb. Each extent field 
is composed of 6 bytes. The first two bytes 
represent the number of sectors in that 
extent. The last four bytes are the logical 
sector number of the first sector in that 
extent. 

For tty fcbs, this field is set to zero. 



( f cbtapedi rl en) (2) 



For tape fcbs, the first two bytes of this 
field contain the length of the directory 
name associated with this file. 

(f cbtapedi rname) (178) The other 178 bytes contain the directory 

name. 

fcbnotcksum 2 The fcb's notted checksum 

Hie format of the last 242 bytes of the fcb for "continuation" fcbs 
(disk only) is as follows: 



fcbcontextblk 



fcbnotcksum 



240 File extent fields in a continuation fcb. 

There are 40 extent fields in a continuation 
fcb. Each extent field is composed of 6 
bytes. The first two bytes represent the 
number of sectors in that extent. The last 
four bytes are the logical sector number 
of the first sector in that extent. 
2 The fcb's notted checksum 



The process can obtain the fcb for any file currently opened with 
read and/or write access by the process on any device. 

Related Privileges: 

None. 



Parameters: 

lun 
cont 

fcbuff 



- Logical unit number of file whose fcb is requested. 

- Which part of the fcb for this file is desired. 
0=primary fcb f l=lst continuation fcb... 

- Address of 256 byte buffer to receive the fcb. This 
buffer must be word aligned. 
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status - Address of a long word to receive the result of 
the operation. 



Diagnostics: 



erridxrange (56) Hie table ends before the specified occurrence, 
errinvlfn (132) The logical unit number does not correspond 

to an open file, 
errnoreadacc (141) The process does not have read-access to the 

file. 

See Also: 

_create - Create a file 

_open - Open a file 

_setfcb - Write file control block 

Assembler Calling Sequence: 

%%sys$disk/sysincl . sys/f cbdisp. asm 

push lun ;value - logical unit number 

push cont ; value - continuation fcb number 

push fcbuff ; address - buffer to receive the fcb 

push status ;address - result of the operation 

jsr _getfcb ;get file control block 

C Function Declaration: 

#incl ude "sy s $disk/sy sincl . sy s/ f cbdisp. h" 

/* get file control block */ 

long /* returns result of the operation */ 

_getfcb (lun, cont, fcbuff) 

long lun; /* logical unit number */ 

long cont; /* continuation fcb number */ 

fcbtype *fcbuff ; /* buffer to receive the fcb */ 

FORERAN Subroutine Declaration: 

c ! get file control block 

subroutine _getfcb(lun, cont, fcbuff, status) 
integer*4 lun ! logical unit number 
integer*4 cont I continuation fcb number 
character* (*) fcbuff i buffer to receive the fcb 
integer*4 status ! result of the operation 
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Pascal Procedure Declaration: 

%%sys§disk/sysincl . sys/f cbdisp. pas 

procedure _getfcb( {** get file control block) 

lun : longint; {** logical unit number) 
cont : longint; {** continuation FCB number) 
fcbuff : ~array_of_char;{** buffer to receive the FCB) 
var status : longint {** result of the operation) 

) ; external ; 
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GETFID 



Get file ID. 



Description: 

Retrieves the file id on an open file. The file id 
is a user specified identifier that can be associated 
with a file. 

The file id can be retrieved on any disk file open for 
read access. 

Related Privileges: 

None. 
Parameters : 

lun - The logical unit number of the open file whose 

file id is sought, 
fid - Address of a long word to receive the file id. 

The file id will be moved to the least significant 

16 bit word of this long word, 
status - Address of a long word to receive the result of 

the operation. 



Diagnostics : 
errinvlfn 

errnoreadacc 

errinvcloper 



(132) The logical unit number does not correspond 

to an open file. 
(141) The process does not have read-access to the 

file. 
(173) The device class is inappropriate for the 

operation. 



See Also: 

_setfid - Set file id 
Assembler Calling Sequence: 



push 


lun 


push 


fid 


push 


status 


jsr 


getfid 



C Function Declaration: 



long 



;value - logical unit number 
jaddress - file id 
jaddress - result of the operation 
;get file id 



/* get file id */ 

/* returns result of the operation */ 
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Dictionary of MCS System Calls 
getfid 



_getfid(lun, fid) 
long lun; 
long *fid; 

Fortran Subroutine Declaration: 



/* logical unit number */ 
/* file id */ 



! get file id 

subroutine getfid(lun, fid, status) 

integer*4 lun ! logical unit number 

integer*4 fid ! file id 

integer*4 status ! result of the operation 



Pascal Procedure Declaration: 

procedure __getfid( 

lun : longint; 

var fid : longint; 

var status : longint 
); external; 



{** get file id} 

{** logical unit number} 

{** file id} 

{** result of the operation} 
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GETFNAM 



getfnam 



getfnam - Given a lun, return the filename. 

Description: 

Given the logical unit number (lun) of a file successfully opened 
for read and/or write access by the calling process, the filename 
for this file is returned. This will work on all classes of devices. 

Related Privileges: 

None. 

Parameters : 

lun - Logical unit number (lun) of the file whose name you 

wish to receive. 
fname - Address of a 94 byte buffer to receive the filename. 

The string returned may be up to 93 significant characters 

followed by a null character, 
status - Address of a long word to receive the result of 

the operation. 

Diagnostics : 

errinvlfn (132) The logical unit number does not correspond 

to an open file, 
errnoreadacc (141) The process does not have read-access to the 

file. 

See Also: 

_pfdnam - Given a PFD address, return the filename. 

Assembler Calling Sequence: 

;value - logical unit number 
;address - receives filename string 
; address - result of the operation 
;given a lun, return the filename 

C function declaration: 

/* given a lun, return the filename */ 
long /* returns result of the operation */ 

_getfnam(lun, fname) 

long lun; /* logical unit number */ 

GETFNAM-1 



push 


lun 


push 


fname 


push 


status 


jsr 


_getfnam 



Dictionary of WMCS System Calls 
getfnam 

char fname[94]; /* receive filename string */ 

Fortran Subroutine Declaration: 

c ! given a lun, return the filename 
subroutine getfnadun, fname, status) 

integer*4 lun i logical unit number 
character* (94) fname I receives filename string 

integer* 4 status ! result of the operation 

Pascal Procedure Declaration: 

procedure getfnam ( {** given a lun, return the filename} 

lun : longint; {** logical unit number} 

fname : string [93]; {** receives filename string} 

var status : longint {** result of the operation} 

) ; external; 
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_GETFPRT 

Get file protection. 

Description: 

Retrieves the protection mask on an open file. The 
protection mask determines the type of access to the 
file granted to classes of users. Protection can be 
retrieved on any file open for read or write access 
on the system. 

Related Privileges: 

none - Allows retrieval of the protection if the calling 
process has successfully opened the file for read 
access. 



Parameters: 
lun 

prot 



The logical unit number of the open file whose 
protection mask is sought. 

Address of a long word to receive the protection mask. 
The least significant 16 bit word of this long word 
is divided into 4 nibbles. Each nibble corresponds to 
a class of users. The bits within each nibble represent 
the type of access that class of user is granted for 
the file. If the bit is set (1) the access is granted. 

From the least to the most significant nibble the 
user classes are: 



Ownr - The file owner 

Grp - Processes with the same group id as the owner 

Pub - All other processes in the system 

Sys - Processes with system privilege 

Sys Pub Grp Ownr 
I 1 1 1 1 

I DWRE I DWRE I DWRE I DWRE I 



MSB 



LSB 



From the least to the most significant bit within the 
nibbles, the access privileges are: 

E - Execute access 

R - Read access 

W - Write access 

D - Delete access 
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Dictionary of MCS System Calls 
getfprt 



status - Address of a long word to receive the result of 
the operation. 

Diagnostics: 

errinvlfn (132) The logical unit number does not correspond 

to an open file, 
errnoreadacc (141) The process does not have read-access to the 

file. 

See Also: 



___getdprt - Get device protection 
_setdprt - Set device protection 
__setfprt - Set file protection 

Assembler Calling Sequence: 



push 


lun 


push 


prot 


push 


status 


jsr 


getfprt 



; value - logical unit number 
jaddress - protection mask 
;address - result of the operation 
;get file protection 



C Function Declaration: 



long 

_getfprt(lun, prot) 

long lun; 

long *prot; 

Fortran Subroutine Declaration: 



/* get file protection */ 

/* returns result of the operation */ 

/* logical unit number */ 

/* protection mask */ 



! get file protection 
subroutine getfpr(lun, prot, status) 



integer*4 lun 
integer*4 prot 
integer*4 status 

Pascal Procedure Declaration: 

procedure _getfprt( 

lun : longint; 

var prot : longint; 

var status : longint 
) ; external ; 



! logical unit number 

! protection mask 

! result of the operation 



{** get file protection} 
{** logical unit number} 
{** protection mask} 
{** result of the operation} 
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GETFRE 



Get amount of available memory. 

Description: 

Returns the amount of available memory in the general 
memory pool. The value is in units of 1024 bytes. Only 
represents the amount of memory available in free pages. 

Related Privileges: 

None. 



Parameters : 



siteid 



f remem 
status 



- A long word containing the system id of the 
system whose amount of available memory is sought. 
A siteid of zero (0) corresponds to the system 

on which the calling process is executing. 

- Address of a long word to receive the amount 
of available memory. 

- Address of a long word to receive the result of the 
operation. 



Diagnostics : 

errinvsiteid (8) The specified site id does not exist. 
See Also: 



Assembler Calling Sequence: 



push 


siteid 


push 


f remem 


push 


status 


jsr 


getfre 



C function declaration: 



long 
getfre (siteid, f remem) 

long siteid; 
long *fremem; 

Fortran Subroutine Declaration 



;value - system id 

jaddress - free memory 

jaddress - result of the operation 

;get amount of available memory 



/* get amount of available memory */ 
/* returns result of the operation */ 



/* system id */ 
/* free memory */ 



! get amount of available memory 
subroutine getf re(siteid, f remem, status) 
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Dictionary of MCS System Calls 
getfre 



integer*4 siteid 
integer*4 fremem 
integer*4 status 

Pascal Procedure Declaration: 

procedure __getfre( 

siteid : longint; 

var fremem : longint; 

var status : longint 
); external; 



! system id 

! free memory 

! result of the operation 



{** get amount of available memory} 

{** system id} 

{** free memory} 

{** result of the operation} 
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jGETFRSZ 

Get file record size. 

Description: 

Retrieves the file record size on an open file. The file record size 
is the number of bytes returned when one record is requested from the 
operating system. All files have a default record size that was 
specified when the file was created. The default record size may be 
overridden when the file is subsequently opened for further access. 
This system call returns the current record size that the file system 
has defined for the open file. 

Related Privileges: 

None. 



Parameters: 
lun 
result 

status 



- The logical unit number of the open file whose 
record size is sought. 

- Address of a long word to receive the record size. 
The record size will be moved to the least significant 
16-bit word of this long word. 

- Address of a long word to receive the result of 
the operation. 



Diagnostics : 
errinvlfn 

See Also: 



(132) The logical unit number does not correspond 
to an open file. 



_setf rsz - Set file record size 
Assembler Calling Sequence: 



push 


lun 


push 


result 


push 


status 


jsr 


_getfrsz 



; value - logical unit number 

; address - record size 

; address - result of the operation 

;get file record size 
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Dictionary of WMCS System Calls 
_getfrsz 

C Function Declaration: 



long 

_getfrsz(lun, result) 

long lun; 

long *result; 

FORERAN Subroutine Declarations 



/* get file record size */ 

/* returns result of the operation */ 

/* logical unit number */ 
/* file record size */ 



subroutine _getfrs(lun f 
integer *4 lun 
integer*4 result 
integer *4 status 

Pascal Procedure Declaration: 

procedure _getfrsz( 

lun : longint; 

var result : longint; 

var status : longint 
) ; external ; 



1 get file record size 
result f status) 
! logical unit number 
I file record size 
1 result of the operation 



{** get file record size) 
{** logical unit number) 
{** file record size) 
{** result of the operation} 
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GETFUIC 



Get file UIC. 

Description: 

Given the logical unit number of an open file, returns 
the user identification code (uic) which is composed of 
an owner id and a group id. 

To successfully retrieve the uic of a file, the calling 
process must have successfully opened the file with read 
access. This system call is valid for files of any class. 

Related Privileges: 

None. 
Parameters: 

lun - The logical unit number of the file whose uic is 

requested, 
uic - Address of a long word to receive the user identification 

code. This long word is divided into two fields. 

The most significant 16 bits constitute the owner 

id number. The least significant 16 bits constitute 

the group id number (identifying the group to which 

the user belongs), 
status - Address of a long word to receive the result of 

the operation. 



Diagnostics: 
errinvlfn 
errnoreadacc 



(132) The logical unit number does not correspond 

to an open file. 
(141) The process does not have read-access to the 

specified file. 



See Also: 



getduic - Get device uic 
getuic - Get process uic 
setduic - Set device uic 
"setfuic - Set file uic 
setuic - Set process uic 



Assembler Calling Sequence: 



push 


lun 


push 


uic 


push 


status 



;value - logical unit number 

jaddress - user id code 

jaddress - result of the operation 
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Dictionary of MCS System Calls 
getfuic 



jsr ___getfuic 
C Function Declaration: 



long 
__getfuic(lun, uic) 

long lun; 

long *uic; 

Fortran Subroutine Declaration: 



;get file uic 



/* get file uic */ 

/* returns result of the operation */ 

/* logical unit number */ 

/* user id code */ 



! get file uic 
subroutine getfui(lun, uic, status) 



integer*4 lun 
integer*4 uic 
integer*4 status 

Pascal Procedure Declaration: 

procedure _getfuic( 

lun : longint; 

var uic : longint; 

var status : longint 
) ; external ; 



! logical unit number 

! user id code 

! result of the operation 



{** get file uic} 

{** logical unit number} 

{** user id code} 

{** result of the operation} 
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GETGLB 



Retrieve a global logical name. 

Description: 

Given an index into a system's global logical name table, 
returns the logical name and equivalence associated with 
that index. 

Related Privileges: 

None. 
Parameters: 

index - which entry in the logical name table is desired, 
siteid - Site id of the system whose gobal logical name table 

is being accessed. Zero (0) corresponds to the system 

on which the calling process is executing, 
lname - Address of a 94 byte buffer to receive the 

logical name. String will be null terminated. 

(up to 93 valid characters plus a null) 
equiv - Address of a 94 byte buffer to receive the 

equivalent string associated with the logical 

name, (up to 93 valid characters plus a null) 
status - Address of a long word to receive the result of 

the operation. 

Diagnostics : 

errprcsnotfnd (2) The specified process is not in the system 



errinvsiteid 
erridxrange 



process table. 
(8) The specified site id does not exist. 
(56) The table ends before the specified occurrence 



See Also: 



__assign - Assign a logical name 

__gassign - Assign a global logical name 

__getlog - Retreive a logical name 

_trans - Translate a logical name 

Assembler Calling Sequence: 



push 


index 


push 


siteid 


push 


lname 


push 


equiv 


push 


status 


jsr 


getglb 



;value - index into the table 

;value - system id 

;address - logical name 

;address - equivalent 

jaddress - result of the operation 

jretrieve a global logical name 
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Dictionary of MCS System Calls 
__getglb 

C function declaration: 

/* retrieve a global logical name */ 

long /* returns result of the operation */ 
__getglb( index, siteid, lname, equiv) 

long index; /* index into the table */ 

long siteid; /* system id */ 

char lname[94]; /* logical name */ 

char equiv[94]; /* equivalent */ 

Fortran Subroutine Declaration: 

c ! retrieve a global logical name 

subroutine getglb(index, siteid, lname, equiv, status) 



integer*4 index 
integer*4 siteid 
character*94 lname 
character*94 equiv 
integer*4 status 

Pascal Procedure Declaration: 



index into the table 

system id 

logical name 

equivalent 

result of the operation 



procedure _getglb( 
index 
siteid 
var lname 
var equiv 
var status 
); external; 



longint ; 
longint ; 
string[93]; 
string[93]; 
longint 



{** retrieve a global logical name} 

{** index into the table} 

{** system id} 

{** logical name} 

{** equivalent} 

{** result of the operation} 
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_GETINST 
Get installed files. 
Description: 

This call is used to obtain a list of installed files. 

Given an index into the system table of installed files, 
this call returns the corresponding entry which is composed 
of the name of the installed file (in fcb.seq format) and 
a privilege mask indicating which privileges the file is 
granted. 

Related Privileges: 

None. 

Parameters : 

siteid - A long word containing the system id number of 
the system whose table of privileged images is 
requested. A siteid of zero (0) corresponds to 
the system on which the calling process is 
executing. 

index - The index into the system table of the file 

whose name and privilege are requested. The first 
entry in the table has an index of zero. 

fcbnam - Address of a string to receive the name of the 
file in fcb.seq format. The returned name may 
contain up to 93 significant characters and will 
be null terminated. 

priv - Address of a long word to receive the privilege mask. 
The privilege mask is a bit mask of privileges 
to be assigned to process when it is created using 
__crproc. Privileges are bit encoded as follows: 
Bit Name Bit # Description 





pcbpvsetpriv 

pcbpvsystem 

pcbpvreadphys 

pcbpvwritephys 

pcbpvsetprior 

pcbpvchngsuper 

pcbpvbypass 



1 
2 
3 
A 
5 
6 




setpriv 

system 

readphys 

writephys 

setprior 

chngsuper 

bypass 




pcbpvoperator 

pcbpvaltuic 

pcbpvworld 


7 
8 
9 




operator 

altuic 

world 




pcbpvgroup 


10 
11- 


31 


group 
Reserved. 


status 


- Address of a 1 


ong 


word to receive the result 



of 



the operation. 
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Dictionary of MCS System Calls 
getinst 



Diagnostics: 

errinvsiteid (8) 

erridxrange (56) 

er rundevnam (131) 



The specified site id does not exist. 
The table ends before the specified occurrence. 
The MCS does not recognize the devicename. Is 
the device mounted? 



See Also: 



_deinst - Deinstall privileged file 
install - Install privileged file 



Assembler Calling Sequence: 



push 


siteid 


push 


index 


push 


fcbnam 


push 


priv 


push 


status 


jsr 


getinst 



; value - system id 
;value - index into table 
jaddress - fcb.seq file name 
;address - privilege mask 
jaddress - result of the operation 
;Get installed privileged file 



C Function Declaration: 



/* get installed privileged file */ 
long /* returns result of the operation 

__getinst (siteid, index, fcbnam, priv) 

long siteid; /* system id */ 

long index; /* index into table */ 

char fcbnara[94]; /* fcb.seq file name */ 

long *priv; /* privilege mask */ 

Fortran Subroutine Declaration: 

c ! get installed privileged file 

subroutine getins(siteid, index, fcbnam, priv, status) 



integer*4 siteid 
integer*4 index 
character*94 fcbnam 
integer*4 priv 
integer*4 status 

Pascal Procedure Declaration: 



procedure getinst ( 



siteid 
index 
var fcbnam 
var priv 
var status 
external ; 



longint ; 
longint ; 
string[93] ; 
longint; 
longint 



system id 

index into table 

fcb.seq file name 

privilege mask 

result of the operation 



{** get installed privileged file} 

{** system id} 

{** index into table} 

{** fcb.seq file name} 

{** privilege mask} 

{** result of the operation} 
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GETLOG 



Retrieve a logical name. 

Description: 

Given an index into a given process's logical name table, 
returns the logical name and equivalence associated with 
that index. 

Related Privileges: 



None 



group 



world 



Parameters: 



- Allows retrieval of logical names from tables 
of processes with the same user and group id 
(uic) as the current process. 

- Allows retrieval of logical names from tables 
of processes with the same group id as the 
current process . 

- Allows retrieval of logical names from tables 
of any process in the system. 



index - which entry in the logical name table is desired, 
pid - Process id of the process whose logical name table 

is being accessed. 0=current process, -l=parent process, 
lname - Address of a 94 byte buffer to receive the 

logical name. String will be null terminated. 

(up to 93 valid characters plus a null). 

If an error is detected, this buffer will remain 

unmodified, 
equiv - Address of a 94 byte buffer to receive the 

equivalent string associated with the logical 

name, (up to 93 valid characters plus a null) 

If an error is detected, this buffer will remain 

unmodified, 
status - Address of a long word to receive the result of 

the operation. 

Diagnostics: 

errinsufpriv (1) The process lacks the privileges required to 

perform the operation, 
errprcsnotfnd (2) The specified process is not in the system 

process table, 
erridxrange (56) The table ends before the specified occurrence 

See Also: 

__assign - Assign a logical name 
gassign - Assign a global logical name 
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Dictionary of MCS System Calls 
getlog 



__getglb - Retreive a global logical name 
_gengy - Get pid of ancestor process 
trans - Translate a logical name 



Assembler Calling Sequence: 



push 


index 


push 


pid 


push 


lname 


push 


equiv 


push 


status 


jsr 


getlog 



jvalue - index into the table 

;value - process id 

;address - logical name 

jaddress - equivalent 

jaddress - result of the operation 

jretrieve a logical name 



C function declaration: 



long 



getlog( index, pid, lname, equiv) 
long index; 
long pid; 
char lname [94] ; 
char equiv [94] ; 



Fortran Subroutine Declaration: 



/* retrieve a logical name */ 

/* returns result of the operation */ 

/* index into the table */ 
/* process id */ 
/* logical name */ 
/* equivalent */ 



! retrieve a logical name 

subroutine getlog(index, pid, lname, equiv, status) 
integer*4 index 
integer*4 pid 
character*94 lname 



character*94 equiv 
integer*4 status 

Pascal Procedure Declaration: 



! index into the table 

! process id 

! logical name 

! equivalent 

! result of the operation 



procedure _getlog( 
index 
pid 
var lname 
var equiv 
var status 
) ; external ; 



longint ; 
longint ; 
string[93]; 
string[93]; 
longint 



{** retrieve a logical name} 

{** index into the table} 

{** process id} 

{** logical name} 

{** equivalent} 

{** result of the operation} 
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GESMLST 



getmlst 



getmlst - Get an entry from list of named shared memory areas 

Description: 

The operating system maintains a control structure for each named 
sharable memory area. _Getmlst is used to obtain a copy of one of 
these control structures. INDEX specifies an offset into the list 
of shared memory area control structures. A value of zero will 
reference the first entry in the list. If too large a value is 
specified, _getmlst will indicate an error. This system call 
is used to obtain a description of the named sharable memory 
areas which are defined in the system. 

Related Privileges: 

None. 

Parameters : 



siteid 

index 

bsize 
buffer 



A long word containing the address of the system 

from whom the information is needed. If SITEID 

is zero, the current system is referenced. 

A long word which is the offset into the list 

of shared memory areas. A value of zero returns 

the first entry in the list. 

A long word containing the maximum size of the 

buffer BUFFER. 

Address of an area to receive a copy of the 

of the named sharable memory control structure. 





Length 




Name 


(bytes) 
4 


Description 


nsm _f_J.ink 


Forward link 


nsm b__Zink 


4 


Back link 


nsm struct size 


2 


Structure size in bytes 


nsm id__tag 


2 


Structure id tag = $3542 


nsm mod_pid 


4 


PID of last modifier 


nsm ref__cnt 


2 


Structure reference count 


nsm status 


2 


Status word 


Bit Name 




Bit # Description 



nsm linger bit The linger bit 
nsm node_linked_bit 1 Node linked into chain bit 
nsm protection 2 Memory protection mask 
nsm mem_size 4 Size of memory area in byte c 
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getmlst 



nan lock__que 4 

nsm.uic 4 

nsm namelen 2 

nsm name 94 

nsm page_cnt 2 



Access queue to region 

UIC of def iner 

Length of name of memory area 

Name of memory area 

Number of pages in page list 



retlen 
status 

Diagnostics : 

erridxrange 
errinvadr 

See Also: 

_defmem 

_udefmem - 

__shrmem — 

„ushrmem - 

_setmuic - 

_setmprt - 



- Address of a long word to receive the size 
of the control structure in units of bytes. 

- Address of a long word to receive the result of 
the operation. 



( 56) The index is beyond the end of the table. 

( 4) The memory address is not on a 4K page boundary. 



Define a named sharable memory area. 

Undefine a named sharable memory area. 

Share a named sharable memory area. 

Unshare a named sharable memory area. 

Change owner of a named sharable memory area. 

Change protection of a named sharable memory area. 



Assembler Calling Sequence: 



push 
push 
push 
push 
push 
push 
jsr 



siteid 

index 

Imtab 

mtable 

retlen 

status 

_getmlst 



value - system site id 
value - sequence number 
value - length of mtable 
address - memory table 
address - # of bytes transferred 
address - result of the operation 
Get an entry from list of named 
shared memory areas 



C Function Declaration: 



long 

_getmlst (siteid, index, 

long siteid; 

long index; 

long lmtab; 

nsm mtable; 

long * retlen; 



/* Get an entry from list of named */ 
/* shared memory areas */ 
/* returns result of the operation */ 
lmtab, mtable, retlen) 

/* system site id */ 

sequence number */ 

length of mtable */ 

memory table */ 

# of bytes transferred */ 



/* 
/* 
/* 
/* 



FORTRAN Subroutine Declaration: 
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Dictionary of WMCS System Calls 

getmlst 



getmls (siteid, index, 

integer*4 siteid I 

integer *4 index I 

integer* 4 Imtab ! 
character*1024 ratable 

integer* 4 retlen ! 

integer*4 status ! 



i Get an entry from list of named 
! shared memory areas 
Imtab, ratable, retlen, status) 



PASCAL Procedure Declaration: 



procedure getmlst ( 



siteid 
index 
Imtab 
ratable 
var retlen 
var status 
) ; external; 



longint; 

longint; 

longint; 

nsm; 

longint; 

longint 



system site id 

sequence number 

length of ratable 

I memory table 

# of bytes transferred 

result of the operation 






get an entry from list of named} 

shared memory areas} 
{** system site id } 
{** sequence number } 
{** length of ratable} 
{** memory table} 

# of bytes transferred} 

result of the operation} 
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_GETNNAM 

Get nodename from site ID. 

Description: 

This SVC returns the name of a node that is associated with the 
specified site ID. 

Related Privileges: 

none - No privileges are needed to execute this SVC. 

Parameters: 



siteid 
nname 



status 



Diagnostics : 



This parameter is a long word containing the site 

ID for which the nodename is desired. 

This parameter is the address of a string buffer 

in which will be placed the name of the node 

for the specified siteid. A nodename always 

begins with two underscores. The string is 

null terminated. 

Address of a long word to receive the result of 

the operation. 



errinvsiteid 
errnoclass 



(8) The specified site ID does not exist. 
(185) The device class handler was not loaded when 
the system was booted. 



See Also: 



_getnsid - Get site ID from nodename 
Assembler Calling Sequence: 



push 


siteid 


push 


nname 


push 


status 


jsr 


_getnnam 



value - site id 
address - for nodename 
address - result of the operation 
get name of node 
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_getnnam 



C Function Declaration: 

long 

_getnnam( siteid, nname) 

long siteid; 

char nname [94]; 

F0R3RAN Subroutine Declaration: 



/* Get nodename for site id */ 

/* returns result of the operation */ 

/* Site id */ 

/* Returned nodename */ 



! Get nodename from site id 
subroutine _getnna (siteid, nname, status) 
integer*4 siteid I Site id 
character*94 nname 1 Returned nodename 
integer*4 status ! Result of operation 



Pascal Procedure Declaration: 

procedure _getnnam( 

siteid : longint; 

var nname : string [933; 

var status : longint 
) ; external; 



{** Get nodename from site id } 

{** Site id > 

{** Returned nodename } 

{** Result of operation } 
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Get site ID from nodename. 
Description: 

This SVC returns the site ID for a given nodename. 
Related Privileges: 

none - No privileges are needed to execute this SVC. 



Parameters: 
nname 
siteid 

status 



- This parameter is the address of a null terminated 
string which contains the nodename. 

- This parameter is the address of a longword 
which will receive the site ID for the given 
nodename. 

- Address of a long word to receive the result of 
the operation. 



Diagnostics : 

errnonodefnd 
errnoclass 



(53) The nodename is not defined. 
(185) The device class handler was not loaded when 
the system was booted. 



See Also: 

_getnnam - Get nodename from site ID 
Assembler Calling Sequence: 



push 
push 
push 
jsr 


nname 
siteid 
status 
_getnsid 


tction 


Declaration: 


long 

_getnsid (nname , siteid) 
char nname [94] 
long *siteid; 



address - nodename 

address - for siteid 

address - result of the operation 

get site id for nodename 



/* Get site id from nodename*/ 

/* Returns result of the operation */ 

/* nodename */ 

/* Returned site id */ 
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P0R3RAN Subroutine Declaration: 

c I Get site id from nodename 
subroutine _getnsi (nname, siteid, status) 

character *94 nname I nodename 

integer*4 siteid 1 Returned site id 

integer*4 status I Result of operation 

Pascal Procedure Declaration: 

{** Get site id from nodename } 
procedure _getnsid( 

nname : string [93]; {** nodename } 

var siteid : longint; {** Returned site id } 

var status : longint {** Result of operation } 
) ; external; 
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GETPCB 



Get process control block. 
Description: 



Given the process ID (PID) of a process in the system, copy the 
process control block (PCB) for that process into the buffer of the 
calling process. 

CAUTION: The format of the process control block may change with 
each release of the operating system. The current 
definition is included in each release in the file 
named /SYSINCL.Sys/PRCSDISP.*. The name of the record 
is "pcbtable", i.e. in your program, you can declare a 
variable whose type is "pcbtable". 

The format of the PCB is as follows: 



Name 



Length 

(bytes) Description 



pcbnextlink 

pcbbacklink 

pcbsysidnum 

pcbidnum 

pcbname 
pcbstatus 



4 Forward link to next pcb on same priority 

level 
4 Backward link to previous pcb on same 

priority level 
2 Contains the system ID number (the most 

significant word of the PID) 
2 Contains the least significant word of 

the PID 
16 The process name 
4 A bit encoded long word representing the 

process status. If the bit is asserted (1) , 

the corresponding status applies. 



Bit name 
pcbsttoabort 



Bit # Description 



pcbsttohibernate 



Process is to be 
scheduled for deletion 
(i.e. the next time 
this process is 
scheduled, send it to 
the delete process 
routines) 
Reserved 
Process is to be 
hibernated 
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pcbstabrinprgs 3 

pcbstexhinprgs 4 

pcbst real time 5 

pcbstswapped 6 

pcbsthaschild 7 



pcbstnocontc 



8 



pcbsterrreport 10 

11 
pcbstextndfcb 12 

pcbstbadseclog 13 

pcbstksam 14 

15 
pcbstcrprcs 16 

pcbstcleanup 17 

pcbstinque 18 

pcbstcrashdisp 19 



pcbstalarmset 
pcbstsupervisor 


20 
21 


pcbstmulcrps 


22 


pcbstdisperr 


23 


pcbsttracing 


24 


pcbstfppending 


25 


pcbstsur rogate 


26 
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Process is currently 

being deleted, (i.e. 

process is currently 

executing the delete 

process routines) 

Process is executing its 

exit handler 

Process is in real time 

mode 

Process has been swapped 

Process is in a child 

wait state 

Process may receive 

CCRL/C without aborting 

Reserved 

Process is reporting a 

system error 

Reserved 

Process is extending the 

fcb.sys file 

Process is logging a bad 

sector 

Process is accessing a 

KSAM file 

Reserved 

Process is loading an 

image 

Set when closing files 

when dying 

Process is waiting in a 

queue 

If set, suppress crash 

displays 

An alarm has been set 

The call was issued 

while the processor was 

in supervisor mode 

Multiple create process 

is in progress. 

If set, a crash report 

has been displayed 

If set, process is 

tracing 

If set, a floating point 

exception is pending 

If set, this is an NSP 

for networking 



Dictionary of WMCS System Calls 

__getpcb 



pcbtimeslice 



pcbmathtype 1 

pcbmathptr 1 

pcbprsize 2 

pcbprivilege 2 



pcbstsurrchild 27 If set, this is the 

child of a surrogate 
28-31 Reserved 
The process time slice value, i.e., the 
maximum amount of time (specified in .01 
milliseconds. That is, a time slice of 100 
represents 1 millisecond.) that the non-real 
time process will be allowed to run each 
time it is scheduled. 

She type of floating point harcVare in use 
The valid types are: 

1 - skyl board 

2 - ndp2 board 

3 - f fpl board 

The math pointer. Contains the index of 
this process's window on the hardware floating 
point board. 

The number of pages of memory currently 
allocated to this process. Each page is 
4K bytes. 

The privileges granted to the current 
process. This is a bit encoded field. 
The privilege is granted when the 
corresponding bit is set. 
Bit Name Bit # Description 
pcbpvsetpriv setpriv - Process may 

assign more privileges 
than it currently has. 

1 system - Process has 
system access to files 

2 readphys - Process can 
do physical read 
operations to devices 
and memory 

3 writephys - Process 
can do physical write 
operations to devices 
and memory 

4 setprior - Process can 
increase the process 
priority 

5 chngsuper - Process 
can change to 
supervisor mode of 
execution 



pcbpvsystem 
pcbpvxeadphys 



pcbpvwritephys 



pcbpvsetprior 



pcbpvchngsuper 
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pcbuserid 2 

pcbgroupid 2 

pcbchildpcbadr 4 

pcbparntpcbadr 4 

pcbcurpriority 2 

pcbalarmtime 8 

pcbtimeout 8 

pcbnondelcnt 2 

pcbcriticalcnt 2 

pcbusp 4 

pcbssp 4 

pcbevntfl 4 

pcbimgsiteid 2 



pcbpvbypass 



pcbpvoperator 



pcbpvaltuic 



pcbpvworld 



pcbpvgroup 



pcbpvnetwork 
pcbpvsetattr 



10 



11 



12 



13-15 



bypass - Process can 
access files and 
devices independently 
of file protection 
operator - Process can 
perform operator 
functions 

altuic - Process can 
have access to files 
as though it had the 
same user and group id 
(uic) as the owner of 
the process image 
world - Process can 
affect any process 
in the system 
group - Process can 
affect any process 
with the same group id 
as itself 

network - Process can 
do network accesses 
setattr - Process can 
modify its attributes 
Reserved 



The owner ID of the process (most significant 

word of the uic) 

The group ID of the process (least significant 

word of the uic) 

Address of the pcb for the child process of 

this process 

Address of the pcb for the parent process of 

this process 

The current priority level 

The date and time at which to issue the alarm 

The date and time at which the current 

operation will time out 

Non-delete count 

Critical code count 

The user stack pointer 

The system stack pointer 

The process event flags 

Site ID of the image file 
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pcbattributes 



pcbimgdevseqnum 2 

pcbirogfcbnum 4 

pcbimgseqnum 2 

pcbstacktop 4 

pcbparabortsts 4 

pcbexithdr 4 

pcbabortreason 4 



Attributes pertaining to the current process. 
This is a bit encoded field. The attribute is 
given when the corresponding bit is set. Note 
that these offsets are defined for being in 
the high order word of a longword. Because it 
is only a word in the PCB, if you access the 
PCB directly you will have to subtract 16 from 
these numbers. 
Bit Name Bit # Description 



pcbattrdesencrypt 16 



pcbattrfastencrypt 17 



pcbattruserl 
pcbattruser2 
pcbattruser3 
pcbattruser4 



23 



24 



25 



26 



pcbattrnowatchdog 27 



If set, do network 

encryption with DES 

algorithm 

If set, do network 

encryption with fast 

algorithm 

If set, user attribute 

bit 1 

If set, 

bit 2 

If set, 

bit 3 

If set, 

bit 4 

If set, 



user attribute 



user attribute 



user attribute 



pcbattrpostzeromem 30 



31 



cannot be 
killed by WATCHDOG 
utility 
pcbattrnotswappable 28 If set, cannot swap 

this process 
pcbattrprezeromem 29 If set, pages are 

zeroed as they are 
allocated 
If set, pages are 
zeroed as they are 
released 

If set, other set bits 
will be set 
The mount sequence number of the device that 
contains the image file from which this 
process was initiated 

The fcb number of the image file from which 
this process was initiated 
The sequence number of the image file 
from which this process was initiated 
Address of the top of the system stack 
Address of where to put status in parent 
Address of the process's exit handler 
Reason code why this process terminated 



pcbattrforceset 
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_getpcb 




pcblogiclink 


4 


pcblogioque 


4 


pcbdefdevadr 


4 


pcbdefdevseqnum 


2 


pcbdeffcbnum 


4 


pcbdefseqnum 


2 


pcbdefstrlen 


2 


pcbdefdiradr 


4 


pcbdefdirlen 


2 


pcbofpadr 


4 


pcbkpfdadr 


4 


pcbqueadr 


4 


pcbnetpcktnum 


2 


pcbtrapvecs 


64 


pcbOdivide 


4 


pcbchktrap 


4 


pcbtrapv 


4 


pcbtracetrap 


4 


pcblinelOlO 


4 


pcblinellll 


4 


pcbdefexithand 


4 


pcbfpinthand 


4 


pcbtrapreserved 


16 


pcbloaderaddr 


4 


pcbevntflque 


4 


pcbtrapreturn 


4 


pcbtrapnum 


2 


pcbmailptr 


4 


pctmailque 


4 


pcbdefaultprot 


2 


pcbaltuserid 


2 


pcbaltgroupid 


2 


pcbhibercnt 


2 


pcbschedcnt 


4 


pcbnsmaddr 


4 


pcbnetpageaddr 


4 


pcbraldrl isthead 


8 



pcballochdr 



Address of the logical name table for process 

Queue for linking logical names 

Address of the device table for the default 

device for this process 

The mount sequence number of the default 

device for this process 

fcb number for the current default directory 

sequence number for the current default 

directory 

Length of the default device string 

Address of the default directory string 

Length of the default directory string 

List head to open files 

List head to open ksam files 

Address of the pcb of next entry in 

whatever queue this process is waiting in. 

Network packet number 

Trap handler addresses 

Divide by zero trap handler address 

Check trap handler address 

Overflow trap handler address 

Trace trap handler address 

1010 emulation trap handler address 

1111 emulation trap handler address 

Define exit tran handler 

Floating point interrupt handler 

Reserved space for future trap handlers 

Address of loader routine 

Queue for event flag synchronization 

Trap return address 

The current trap number 

Address of the head node for pending mail 

Queue for processes waiting for mail 

The default protection mask 

Hie user ID number of the image file 

The group ID number of the image file 

Count of how many times this process has been 

hibernated 

Count of how many times this process has been 

scheduled. 

List head for named shared memory regions 

that are currently mapped into this process 

Holds network packet page address 

List head for control information by various 

MCS loaders. 

List head for devices that are allocated to 

this process 
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pcborigprivilege 2 



pcbdefaultnode 4 

pcbcurtrapnum 4 

pcbcurtrapprm 4 

pcbremotepid 4 

pcbremoteuic 4 

pcbremotepriv 2 

pcbrctadr 4 

pcbbasepriority 2 

pcbcurstate 4 



pcbswaptslice 2 
pcbremotetslice 2 

pcbremoteattr 2 

pcbremoteprior 2 

pcbnoswapcnt 2 

pcbpagecnt 2 

pcbreserved 16 

pcbidfield 2 
pc±>idtag $3333 

pcbmemory 1024 

pcbdevstr 94 

Related Privileges: 

None. 



Holds original privileges process was created 

with before any installed privileges were 

added in. 

Contains siteid of current default node 

The number of current SVCs being executed 

Hie stack address of current trap parameters 

If this is an NSP, this is PID of originator 

If this is an NSP, this is UIC of originator 

If this is an NSP, this is priv of originator 

List head for remote connection table 

Holds base priority level 

Index into scheduling queues for current state 

Queue Name Offset Description 

List for processes to 

be swapped in 
4 List for active 

processes 
8 All processes above 

here are in normal 

sleeps 
8 List for processes 

in I/O wait 
12 List for processes 

in hibernation 
16 List for processes 

in child wait 
20 Holds size of this 

scheduling queue 
Holds # of timeslices after swapin to get 
If this is an NSP, timeslice of originator 
If this is an NSP, attributes of originator 
If this is an NSP, priority of originator 
If non-zero, process is swap critical 
Holds size of this pcb in pages 
Peservedspace 
Table ID tag value 
Table ID value 

The process's memory mapping registers 
The default device/directory string 



pcbcst_toswapin 

pcbcst_active 

pcbcst^asleep 

pcbcst_iowait 
pcbcstjiibernate 
pcbcst_chilowait 
pcbcst u _sqsize 
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Parameters: 

pid 

pcbuff 

len 

retlen 

status 

Diagnostics : 



Process ID of the process whose PCB is desired.' 
Address of the buffer to receive the PCB 
The number of bytes requested. This number of 
bytes will be copied into the users buffer. 
Address of where to return the number of bytes 
actually copied into the users buffer. 
Address of a long word to receive the result of 
the operation. 



errinsufpriv 
errprcsnotfnd 



(1) The process lacks the privileges required to 
perform the operation. 

(2) The specified process is not in the system 
process table. 



See Also: 



_gengy - Get PID of ancestor process 
__getpid - Get process ID (PID) from name 
_getpnam - Get process name from PID 
_prclst - Get PIDs on a priority level 



Assembler Calling Sequence: 



push 
push 
push 
push 
push 
jsr 



pid 

pcbuff 

len 

retlen 

status 

.jgetpcb 



; value - process id 

; address - buffer to receive pcb 

; value - length of buffer 

; address - # of bytes transferred 

;address - result of the operation 

;get process control block 



C Function Declaration: 



♦include n sys$disk/sysincl . sys/pcbdisp. h" 

/* get process control block */ 

long /* returns result of the operation */ 

_getpcb(pid, pcbuff , len, retlen) 

long pid; /* process id */ 

pcbtable *pcbuff ; /* buffer to receive pcb */ 

long len; /* length of buffer */ 

long *retlen; /* # of bytes transferred */ 
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FORTRAN Subroutine Declaration: 



c 1 get process control block 

subroutine _getpcb(pid, pcbuff, len, retlen, status) 
integer *4 pid I process id 
character* (*) pcbuff ! buffer to receive pcb 
integer*4 len ! length of buffer 
integer *4 retlen I # of bytes transferred 
integer*4 status 1 result of the operation 

Pascal Procedure Declaration: 

%%sys$disk/sysincl . sys/pcbdisp. pas 

procedure _getpcb( {** get process control block) 

pid : longint; {** process id) 
pcbuff : ~array_of_char; {** buffer to receive PCB) 
len : longint; {** length of buffer) 
var retlen : longint; {** # of bytes transferred) 
var status : longint {** result of the operation) 
) ; external ; 
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Get process ID (PID) from name. 

Description: 

This system call returns the process id (pid) of the highest 
priority process whose name matches the name supplied in the 
call. If there is more than one process with the specified 
name, the pid of the process closest to being scheduled again 
will be returned. 

Related Privileges: 

None. 
Parameters : 

siteid - A long word containing the siteid of the system 

on which the named process is executing. A siteid 

of zero (0) corresponds to the system on which the 

calling process is executing. 

Address of a 17 byte buffer containing the name 

of the process whose pid is requested. The process 

name is null terminated with up to 16 valid characters. 

• Address of a long word to receive the process id. 

■ Address of a long word to receive the result of 
the operation. 



pname 



pid 
status 



Diagnostics: 

errprcsnotfnd (2) The specified process is not in the system 

process table, 
errinvsiteid (8) The specified site id does not exist. 

See Also: 

__gengy - Get pid of ancestor process 
__getpnam- Get process name from pid 
_prclst - Get pid's on a priority level 

Assembler Calling Sequence: 



push 


siteid 


push 


pname 


push 


pid 


push 


status 


jsr 


getpid 



;value - system id 

jaddress - process name 

jaddress - process id 

jaddress - result of the operation 

;get process id (pid) from name 



C function declaration: 
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long 

_getpid(siteid, pname, pid)] 

long siteid; 

char pname [ 17] ; 

long *pid; 

Fortran Subroutine Declaration: 



/* get process id (pid) from name 

/* returns result of the operation */ 

/* system id */ 
/* process name */ 
/* process id */ 



! get process id (pid) from name 
subroutine getpid(siteid, pname, pid, status) 



integer*4 siteid 
character* 17 pname 
integer*4 pid 
integer*4 status 

Pascal Procedure Declaration: 

procedure _getpid( 

siteid : longint; 
pname : string[16]; 
var pid : longint; 
var status : longint 
); external; 



! system id 

! process name 

! process id 

! result of the operation 



{** get process id (pid) from name} 

{** system id} 

{** process name} 

{** process id} 

{** result of the operation} 
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Get process name from PID. 

Description: 

Given a process id (pid) returns a null terminated 17 byte 
string containing the process name. 

Related Privileges: 

None. 
Parameters: 



pid - Process id of the desired process. 

pname - Address of a 17 byte null terminated string to receive 

the process name. Allows up to 16 significant characters 

plus a null bytes. 

status - Address of a long word to receive the result of 
the operation. 



Diagnostics: 

errprcsnotfnd 

See Also: 



(2) The specified process is not in the system 
process table. 



gengy - Get pid of ancestor process 
getpid - Get process id (pid) from name 
prclst - Get pid's on a priority level 



sembler 


Calling Sequence: 


push 


pid 


push 


pname 


push 


status 


jsr 


getpnam 



C function declaration: 



long 

getpnam(pid, pname) 
~ long pid; 

char pname [ 17] ; 

Fortran Subroutine Declaration: 



;value - process id 

;address - receives the process name 
jaddress - result of the operation 
;get process name from pid 



/* get process name from pid */ 

/* returns result of the operation */ 

/* process id */ 

/* receives the process name */ 



! get process name from pid 
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subroutine getpna(pid, pname, status) 

integer*4 pid ! process id 

character* 17 pname ! receives the process name 

integer*4 status ! result of the operation 

Pascal Procedure Declaration: 

procedure __getpnam( {** get process name from pid} 

pid : longint; {** process id} 

var pname : string[16]; {** string to receive process name} 

var status : longint {** result of the operation} 

) ; external ; 
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__GETPOS 
Get the current file position. 
Description: 

Given a valid logical unit number (lun), returns the current 
file position. This is specified as the relative record 
position (relative to the front of the file) of the next 
record to be read or written. 

Related Privileges: 

None. 

Parameters : 

lun - Logical unit number of desired file. 

recnum - Address of a long word to receive the record position, 
status - Address of a long word to receive the result of 
the operation. 



Diagnostics : 
errinvlfn 

See Also: 



(132) The logical unit number does not correspond 
to an open file. 



_read - Read from an open file 
_setpos - Set the current file position 
write - Write to an open file 

Assembler Calling Sequence: 



push 


lun 


push 


recnum 


push 


status 


jsr 


getpos 



;value - logical unit number 

jaddress - position 

jaddress - result of the operation 

;get the current file position 



C function declaration: 



long 

_getpos(lun, recnum) 

long lun ; 

long *recnum; 

Fortran Subroutine Declaration: 



/* get the current file position */ 
/* returns result of the operation */ 

/* logical unit number */ 
/* position */ 



! get the current file position 
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subroutine getpos (lun, recnum, status) 



integer*4 lun 
integer*4 recnum 
integer*4 status 

Pascal Procedure Declaration: 

procedure _getpos( 

lun : longint; 

var recnum : longint ; 

var status : longint 
) ; external; 



! logical unit number 

! position 

! result of the operation 



{** get the current file position} 

{** logical unit number} 

{** position} 

{** result of the operation} 
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Get a process's priority. 
Description: 



This call allows a process to get its own scheduler priority or the 
priority of another process. There are 16 priority levels numbered 
to 15. Priority level is the highest. 

Related Privileges: 

None. 



Parameters: 



pid 



priort 
status 



- A long word containing the process 3D of the process 
whose priority is to be obtained. refers to the 
current process, -1 refers to the parent of the 
current process. 

- Address of a long word to receive the priority level. 

- Address of a long word to receive the result of 
the operation. 



Diagnostics : 

errprcsnotfnd 

See Also: 



(2) The specified process is not in the system 
process table. 



_prirat - Set priority scheduling ratio 
_setpri - Set process's priority 
.jsettmsl - Change scheduling time slice 



Assembler Calling Sequence: 



push 


pid 


push 


priort 


push 


status 


jsr 


_getpri 



; value - process id 
;address - priority level 
;address - result of the operation 
;get process's priority 
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C Function Declaration: 



long 
_getpri 



(pid, priort) 
long pid; 
long *priort; 



FORERAN Subroutine Declaration: 



/* get process's priority */ 

/* returns result of the operation */ 

/* process id */ 
/* priority level */ 



I get process's priority 
subroutine _getpri(pid, priort, status) 

! process id 
i priority level 
1 result of the operation 



integer*4 pid 
integer *4 priort 
integer*4 status 



Pascal Procedure Declaration: 



procedure _getpri( 

pid : longint; 

var priort : longint; 

var status : longint 
) ; external; 



{** get process's priority > 

{** process id) 

{** priority level) 

{** result of the operation} 
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Get default protection mask. 

Description: 

Retrieves the default protection mask for the process. 
This is the mask that is used for any files created by 
the current process and any child processes of the current 
process. 

Related Privileges: 

None • 



Parameters: 
prot 



Address of a long word to receive the file protection 
mask. The least significant 16 bit word of this 
return value is divided into 4 nibbles. Each nibble 
corresponds to a class of users. The bits within each 
nibble represent the type of access that class of user 
is granted for this file. If the bit is set (1) the 
access is granted. 

From the least to the most significant nibble 
the user classes are: 



Ownr - file owner 

Grp - processes with the same group id as the owner 

Pub - all other processes in the system 

Sys - processes with SYSTEM privilege 



Sys Pub Grp Ownr 
DWRE | DWRE | DWRE | DWRE | 



MSB 



LSB 



From the least to the most significant bits within 
the nibbles, the access privileges are: 





E 


- Execute access 




R 


- Read access 




W 


- Write access 




D 


- Delete access 


Diagnostics : 






None . 






See Also: 
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create - Create a file 
creats - Simplified file creation 
defprot - Set default protection mask 
setfprt- Set file protection 



Assembler Calling Sequence : 



push 

jsr 



prot 
getprot 



C Function Declaration: 



void 

__getprot ( prot ) 

long *prot; 

Fortran Subroutine Declaration: 



subroutine getpro(prot) 
integer*4 prot 

Pascal Procedure Declaration: 

procedure __getprot( 

var prot : longint 
) ; external ; 



;address - protection mask 
;get default protection mask 



/* get default protection mask */ 
/* no result */ 

/* protection mask */ 



! get default protection mask 
! protection mask 



{** get default protection mask} 
{** protection mask} 
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Get process privilege. 

Description: 

Ttiis call allows a process to inspect the privileges assigned in the 
process privilege word of any process in the system. 

Related Privileges: 

None. 

Parameters: 



pid 



priv 



status 



Process id of the process whose privileges 

are to be returned. A pid of represents the 

current process. A pid of -1 represents the 

parent of the current process. 

Address of a long word to receive the privilege 

mask containing a bit mask of privileges assigned 

to the specified process. 

Bit Name Bit Description 

setpriv 

1 system 

2 readphys 

3 writephys 

4 setprior 

5 chngsuper 

6 bypass 

7 operator 

8 altuic 

9 world 

10 group 

11 network 

12 setattr 
13-32 Reserved. 

Address of a long word to receive the result of 
the operation. 



pcbpvsetpriv 

pcbpvsystem 

pcbpvreadphys 

pcbpvwritephys 

pcbpvsetprior 

pcbpvchngsuper 

pcbpvbypass 

pcbpvoperator 

pcbpvaltuic 

pcbpvworld 

pcbpvgroup 

pcbpvnetwork 

pcbpvsetattr 



Diagnostics : 

errprcsnotfnd 



(2) The specified process is not in the system 
process table. 
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See Also: 



_crproc 

_gettmsl 

_setpri 

_setprv 

_settmsl 



Create a new process 
Get scheduling time slice 
Set process priority 
Set process privilege 
Change scheduling time slice 



Assembler Calling Sequence: 



push 
push 
push 
jsr 



pid 
priv 
status 
_getprv 



C Function Declaration: 



; value - process id 
/address - privilege mask 
/address - result of the operation 
;get process privilege 



long 
_getprv(pid, priv) 

long pid; 

long *priv; 

FORTRAN Subroutine Declaration: 



/* get process privilege */ 

/* returns result of the operation */ 

/* process id */ 
/* privilege mask */ 



subroutine _getprv(pid f 
integer*4 pid 
integer *4 priv 
integer*4 status 

Pascal Procedure Declaration: 

procedure _getprv( 

pid : longint; 

var priv : longint; 

var status : longint 
) ; external ; 



! get process privilege 
priv, status) 
1 process id 
1 privilege mask 
! result of the operation 



{** get process privilege) 

{** process id) 

{** privilege mask) 

{** result of the operation) 
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Get names of rotor list elements. 

Description: 

This call returns the names of all the devices assigned to a 
specified rotor list. 

Related Privileges: 

none - No privileges are needed to execute this SVC. 

Parameters: 



rtrnam 



devnms 



maxlen 



status 



- This parameter is the address of a null terminated string 
which contains the name of the rotor list whose elements 
are to be returned. The name supplied will be logically 
translated before use. 

- This parameter is the address of a string buffer in 
which will be placed the names of the devices which 
comprise the rotor list named in the rtrnam parameter. 
All names are separated by commas. The string is null 
terminated. 

- This parameter contains the maximum length of the devnms 
string. Up to this number of characters will be returned. 

- Address of a long word to receive the result of the 
operation. 



Diagnostics : 



errnamenull 
errnoname 



(80) The specified name must not be null. 
(82) The specified name does not exist. 



See Also: 



_alloc 

_dealloc 

_getalc 

_getrtr 

_setrtr 



Allocate an available device. 
Deallocate an allocated device. 
Get names of allocated devices. 
Get rotor list names. 
Assign devicenames to a rotor list. 



Assembler Calling Sequence: 



push 
push 



rtrnam 
devnms 



address - name of rotor list 
address - element list 
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push 
push 
jsr 



raxlen 
status 
_getrel 



C Function Declaration: 



long 

_getrel( rtrnam, devnms, maxlen) 

char rtrnam[94] ; 

char devnms[1025] ; 

long maxlen; 

PORIKAN Subroutine Declaration: 



value - length of devnms 

address - result of the operation 

get names of rotor list elements 



/* get names of rotor list elements */ 
/* returns result of the operation */ 

/* name of rotor list */ 
/* element list */ 
/* length of devnms */ 



I get names of rotor list elements 
subroutine _getrel( rtrnam, devnms r maxlen, status); 
character*94 rtrnam 1 name of rotor list 
character*1024 devnms I element list 
integer*4 maxlen I max length of devnms in bytes 
integer*4 status 1 result of the operation 



Pascal Procedure Declaration: 

procedure _getrel ( 

rtrnam : string[93]; 



var devnms 
maxlen 
var status 
) ; external ; 



string [1024]; 

longint; 

longint 



{** get names of rotor list elements) 

{** name of rotor list) 

{** element list) 

{** length of devnms} 

{** result of the operation) 
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Get rotor list names. 

Description: 

This SVC allows a process to obtain the name of the Nth rotor list 
known to WMCS. The first rotor list known to WMCS has an index of 0. 
In order to get the name of all the rotor lists, call this SVC using 
increasing rotor name indices until the error "erridxrange" is 
returned. Because rotor lists may be defined and/or deleted between 
calls to the SVC, the name of the Nth rotor list may not persist over 
time. If a reliable record of each rotor list is desired, the calling 
process should be running in real-time mode between the first and 
last call to this SVC. 

Related Privileges: 

None. 

Parameters: 

siteid - The site ID of the machine or node that contains the 
rotor list. 

index - The index into the list of rotor names where the first 
rotor name has an index of 0. 

rtrnam - Address of where to store the rotor name. The rotor name 
string will be null terminated. Ihe string provided must 
be at least 10 characters long, allowing for up to 9 
significant characters plus a null. 

status - Address of a long word to receive the result of the 
operation. 

Diagnostics : 

erridxrange (56) The table ends before the specified occurrence. 

See Also: 

_alloc - Allocate an available device 
_dealloc - Deallocate an allocated device 
_getalc - Get names of allocated devices 
_getrel - Get names of rotor list elements 
_setrtr - Assign devicenames to a rotor list 
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Assembler Calling Sequence: 



push 


siteid 


push 


index 


push 


rtrnam 


push 


status 


jsr 


_getrtr 



; value - site ID of rotor list 
;value - rotor name index 
; address - name of indexth rotor 
; address - result of the operation 
;get rotor list names 



C Function Declaration: 



long 

_getrtr (siteid, index, rtrnam) 

long siteid; 

long index; 

char rtrnampClO] 

FORTRAN Subroutine Declaration: 



/* get rotor list names */ 

/* returns result of the operation */ 

/* site ID of rotor list */ 

/* rotor name index */ 

/* name of indexth rotor list */ 



I get rotor list names 
subroutine _getrtr (siteid, index, rtrnam, status) 
integer*4 siteid I site 3D of rotor list 
integer*4 index I rotor name index 
character *10 rtrnam I name of indexth rotor list 
integer*4 status ! result of the operation 



Pascal Procedure Declaration: 

procedure _getrtr ( 

siteid : longint; 
index : longint; 
var rtrnam : string [9]; 
var status : longint 
) ; external ; 



{** get rotor list names) 
{** site ID of rotor list) 
{** rotor name index) 
{** name of indexth rotor list) 
{** result of the operation) 
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Get internal tick count. 

Description: 

Returns a 64-bit unsigned value which is the number of 
.01 second ticks since the system was last booted. 

Related Privileges: 

None. 



Parameters : 
siteid 

mstime 
Is time 
status 



- A long word containing the system id of the 

system whose tick clock is to be read. A system 
id of zero (0) corresponds to the system on 
which the calling process is executing. 

- Address of a long word to receive the most significant 
32 bits of the tick clock 

- Address of a long word to receive the least significant 
32 bits of the tick clock 

- Address of a long word to receive the result of 
the operation. 



Diagnostics : 

errinvsiteid (8) The specified site id does not exist. 

See Also: 

__gettim - Get the current date and time 
_settim - Set system date and time 



Assembler Calling Sequence: 



push 


siteid 


push 


mstime 


push 


Is time 


push 


status 


jsr 


gettic 



C function declaration: 



long 

__gettic (siteid, mstime, lstime) 

long siteid; 

long *mstime; 

long *lstime; 



; value - system id 

jaddress - most significant 4 bytes 
jaddress - least significant 4 bytes 
jaddress - result of the operation 
;get internal tick count 



/* get internal tick count */ 

/* returns result of the operation */ 

/* system id */ 

/* most significant 4 bytes */ 

/* least significant 4 bytes */ 



GETTIC- 1 



Dictionary of MCS System Calls 
gettic 



Fortran Subroutine Declaration: 



! get internal tick count 
subroutine gettic(siteid, mstirae, lstime, status) 
integer*4 siteid ! system id 
integer*4 mstime ! most significant 4 bytes 
integer*4 lstime ! least significant 4 bytes 
integer*4 status ! result of the operation 



Pascal Procedure Declaration: 

procedure _gettic( 

siteid : longint; 

var mstime : longint; 

var lstime : longint; 

var status : longint 
) ; external; 



{** get internal tick count} 
{** system id} 

{** most significant 4 bytes} 
{** least significant 4 bytes} 
{** result of the operation} 
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Get the current date and time. 

Description: 

Read the current system time of day clock. Returns 8 bytes 
containing the contents of the system time of day clock. 
The format of the date and time within these 8 bytes is as 
follows, where byte is the most significant byte. 

Bytes Description 

0,1 The current year (counted from A.D. 0). Example, 1983. 

2,3 The day of the year (1..365 or 1..366) 

4 The hour of the day (0..23) 

5 The minute of the hour (0..59) 

6 The second of the minute (0..59) 

7 The fraction of a second (in lOOths of a second) (0..99) 

Related Privileges: 

None. 
Parameters : 

siteid - A long word containing the system id of the 

system whose time of day clock is to be read. 

A siteid of zero (0) corresponds to the system 

on which the calling process is executing, 
mstime - Address of a long word to receive the most significant 

32 bits of the date and time (actually the year and day 

of the year) 
lstime - Address of a long word to receive the least significant 

32 bits of the date and time (actually the hour, minute, 

second and fraction of a second) 

status - Address of a long word to receive the result of the 
operation. 

Diagnostics : 

errinvsiteid (8) The specified site id does not exist. 

See Also: 

_gettic - Get internal tick count 
_settim - Set system date and time 

Assembler Calling Sequence: 

push siteid ;value - system id 

push mstime jaddress - most significant 4 bytes 
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push 


Is time 


push 
jsr 


status 
gettim 



;address - least significant 4 bytet, 

jaddress - result of the operation 
;get the current date and time 



C function declaration: 



long 

_gettim(siteid, mstime, lstime) 

long siteid; 

long *mstime; 

long *lstime; 



/* get the current date and time */ 
/* returns result of the operation */ 

/* system id */ 

/* most significant 4 bytes */ 

/* least significant 4 bytes */ 



Fortran Subroutine Declaration: 



! get the current date and time 
subroutine gettim(siteid, mstime, lstime, status) 
integer*4 siteid ! system id 
integer*4 mstime ! most significant 4 bytes 
integer*4 lstime ! least significant 4 bytes 
integer*4 status ! result of the operation 



Pascal Procedure Declaration: 



procedure __gettim( 

siteid : longint; 

var mstime : longint; 

var lstime : longint; 

var status : longint 
) ; external; 



{** get the current date and time} 
{** system id} 

{** most significant 4 bytes} 
{** least significant 4 bytes} 
{** result of the operation} 
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Get scheduling time slice. 

Description: 

Retrieve the scheduling time slice of a process. Time slice 
is the maximum amount of time the non-real time process will 
be allowed to execute each time it is scheduled. When the 
time slice is expired, other processes are allowed to execute 
according to the scheduling algorithm. 

Each time slice increment is .01 milliseconds. A time slice 
value of 5000 allows the process to execute up to one twentieth 
of a second (50 milliseconds) each time it is scheduled. A 
time slice value less than 10 results in the process not running 
at all. 

Note that processes will not always use their full time slice. 

When an I/O operation is performed, the process often relinquishes 
control and loses the rest of it's time slice. 

Related Privileges: 

None. 

Parameters: 

pid - The process id of the process whose time slice 

is to be retrieved. represents the current process; 

-1 represents the parent of the current process, 
tslice - Address of a long word to receive the time slice 

value (0.. 65535). Represents the scheduling time slice 

in .01 milliseconds, 
status - Address of a long word to receive the result of 

the operation. 

Diagnostics : 

errprcsnotfnd (2) The specified process is not in the system 

process table. 

See Also: 

__prirat - Set priority scheduling ratio 
setpri - Change process's priority 
settmsl - Change scheduling time slice 

Assembler Calling Sequence: 

push pid ;value - process id 
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push tslice 
push status 
jsr _gettmsl 

C function declaration: 



long 

_gettmsl(pid, tslice) 

long pid; 
long *tslice; 

Fortran Subroutine Declaration: 



;address - time slice 

;address - result of the operation 

;Get scheduling time slice 



/* Get scheduling time slice */ 

/* returns result of the operation */ 



/* process id */ 
/* time slice */ 



! get scheduling time slice 

subroutine gettms(pid, tslice, status) 
integer*4 pid ! process id 
integer*4 tslice ! time slice 
integer*4 status ! result of the operation 



Pascal Procedure Declaration: 

procedure __gettmsl( 

pid : longint; 

var tslice : longint; 

var status : longint 
); external; 



{** get scheduling time slice} 

{** process id} 

{** time slice} 

{** result of the operation} 
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Get process UIC. 

Description: 

Given a process id (pid) returns the user identification 
code (uic) which is composed of an owner id and a group id. 

Related Privileges: 

None. 
Parameters : 

pid - The process id of the process whose uic is requested. 

A process id of corresponds to the calling process. 

A process id of -1 corresponds to the parent of the 

calling process, 
uic - Address of a long word to receive the user identification 

code. This long word is divided into two fields. 

The most significant 16 bits constitute the owner 

id number. The least significant 16 bits constitute 

the group id number (identifying the group to which 

the owner belongs), 
status - Address of a long word to receive the result of 

the operation. 



Diagnostics: 

errprcsnotfnd 

See Also: 



(2) The specified process is not in the system 
process table. 



_getduic - Get device uic 

__getfuic - Get file uic 

__setduic - Set device uic 

_setfuic - Set file uic 

setuic - Set process uic 
Assembler Calling Sequence: 



push 


pid 


push 


uic 


push 


status 


jsr 


getuic 



;value - process id 

jaddress - user id code 

jaddress - result of the operation 

;get process uic 



C Function Declaration: 



/* get process uic */ 
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_getuic 

long 

__getuic(pid, uic) 
long pid; 
long *uic; 

Fortran Subroutine Declaration: 



/* returns result of the operation *■ 

/* process id */ 
/* user id code */ 



! get process uic 

subroutine getuic(pid, uic, status) 

integer*4 pid ! process id 

integer*4 uic ! user id code 

integer*4 status ! result of the operation 



Pascal Procedure Declaration: 



procedure _getuic( 

pid : longint; 

var uic : longint; 

var status : longint 
) ; external ; 



{** get process uic} 

{** process id} 

{** user id code} 

{** result of the operation} 
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Get device status with LUN. • 

Description: 

Given the LUN of a currently mounted device, this system call copies 
the device table and device status into user specified buffers. 
(Contrast this system call with _getdst) . 

WARNING: The format of the device table may change with each 
release. The current definition is included in each 
release in the file /SYSIQCL.SYS/DEVTDISP.*. The record 
definition is named "devicetable", i.e. in your program 
you can declare a variable of type "devicetable." 

The device table for a device contains the information maintained 
about the device by the class handler. The device table is divided 
into two parts. The first part is device independent, and the second 
part is device class dependent. The device independent part is as 
follows: 

Length 
Name (bytes) Description 



dtnextlink 4 Pointer to the next device table 
dtbacklink 4 Pointer to the previous device table 
dtdevname 8 The user supplied devicename 
dtclass 2 Contains the device class. Valid options are: 

Class Name Value Description 

dtclassttyspc Character device (ttyspc) 

dtclasstty 1 Character device (tty) 

dtclasstapespc 2 Tape device (tapespc) 

dtclasstape 3 Tape device (tape) 

dtclassdiskspc 4 Disk device (diskspc) 

dtclassdisk 5 Disk device (disk) 

dtclassnetspc 6 Network dev. (networkspc) 

dtclassnet 7 Network device (network) 

dtclasspipespc 8 Pipe device (pipespc) 

dtclasspipe 9 Pipe device (pipe) 

dtclasssyncspc 10 BSC device (syncspc) 

dtclasssync 11 BCS device (sync) 

dtclassquespc 12 Queue device (quespc) 

dtclassque 13 Queue device (que) 



GIODST-1 



Dictionary of WMCS System Calls 
_giodst 



dtref count 



dtdriveid 
dtallocpid 


4 
4 


dtsiteid 
dtseqnum 


2 
2 


dtdefuserid 


2 


dtdefgroupid 


2 


dtdefprotect 


2 


dtclassptr 

dtdriverptr 

dtflags 


4 
4 
2 



dtfcbptr 



dtblksz 



dtclassnondevspc 14 Non-dev device (nondevspc) 

dtclassnondev 15 Non-dev device (nondev) 

The number of files currently open on the 

device 

Internal drive ID 

The PID of the process that has this device 

allocated 

The site ID of this device 

The mount sequence number of this device. Ihis 

will be unique for each device on the machine. 

The default userid for this device. Ihis will 

be loaded into the DTUSERID variable every 

time the DTREPOOUMT variable goes to zero. 

The default groupid for this device. This will 

be loaded into the DTGRCUPID variable every 

time the DTREEXXXJNT variable goes to zero. 

The default protection mask for this device. 

This will be loaded into the DTPROrEJCT 

variable every time the DTREFOOUNT variable 

goes to zero. 

Address of the class handler for this device 

Address of the device driver for this device 

Device flags. This is a bit encoded word. 



Bit Name Bit 
dtflfcbflushmode 4 



Description 
Current flush mode for 
disk f cbs 

Current flush mode for 
disk cache 
Set if device is 
now being flushed 
Set if the device is 
write protected 
Set if the tape buffer 
has been modified 
Set if a tape file is 
open 

Set if tape is at 
physical end of tape 
Set if tape is at 
logical end of file 
Set if a session is 
currently established 
Address of the file control block of the 
first open file on the device. A list 
head pointer. (Used for disks only) 
Block size for the device 



dtf lchf 1 ushmode 

dtfl flushing 

dtflwriteprot 

dtflwritebuf 

dtflfileopen 

dtfleot 

dtfleof 



8 



11 



12 



13 



dtflsessionestb 15 
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dtuserid 2 

dtgroupid 2 

dtprotect 2 

dtmntmstime 4 

dtmntlstime 4 



dtidfield 2 
dtidtag $5555 



Corresponds 



Corresponds 



(toner id portion of the uic. 

to the owner of the device. 

Group id portion of the uic. 

to the owner of the device. 

The device protection flags. Uses the 

same format at the file protection flags. 

The most significant 32 bits (year and day) 

of the date and time the device was mounted 

The least significant 32 bits (hour, minute, 

second and tick) of the date and time the 

device was mounted 

Table identifier flag 

This is the table id value for this table 



For TTJT, PIPE, S¥NC, and NCNDEV class devices, the second part of the 
table is defined as follows: 



Name 



Length 

(bytes) Description 



dttyreadacc 
dttyreadlock 
dttywriteacc 
dttywritelock 



dttywriteqh 
dttyreadqh 

For TAPE class 
follows: 



1 The read access count (the number of 

times this device has been opened for 

read access) 
1 The read lock count (the number of 

times this device has been opened with 

read lock) 
1 The write access count (the number of 

times this device has been opened for 

write access) 
1 The write lock count (the number of 

times this device has been opened with 

write lock) 
4 Hie write queue header 
4 The read queue header 

devices, the second part of the table is defined as 
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Name 



Length 

(bytes) Description 



dttpreadahead 
dttpfilseqno 

dttpcachesz 

dttpcacheadr 

dttpskpcache 



dttpnextblk 
dttpreadpos 



2 Read ahead flag 

4 Sequence number of currently open file or next 

file to be opened. 
2 Number of elements in tape cache 
4 Address of cache header 
4 Address of special cache header for 

non-buffered commands , i.e. , skip, get or set 

statusr write file mark 
4 Next logical block number in the currently 

open file 
2 Actual block number to be read next physically 



For DISK class devices/ the second part of the table is defined as 
follows: 



Name 



Length 

(bytes) Description 



dtdkflags 



Disk class flags. This 
Bit Name Bit # 
dtdkf lautoflush 

dtdkflreadahead 1 
dtdkf lforceowrite 2 



is a bit encoded word. 

Description 

If set do auto 

flushing 

If set do readahead 

If set do forced 

writes on all writes 



dtdksecshfcnt 
dtdkdef alloc 
dtdksecallcc 
dtdkchreadmin 
dtdkmaxuserch 



dtdkszmaxch 



dtdkcachecol sz 


2 


dtdkcachesze 


2 


dtdkchaddr 


4 


dtdkbmpos 
dtdkf cbbmpos 
dtdkfcbptr 
dtdkdirptr 


4 
4 
4 
4 



The sector shift count 

The initial file allocation 

The secondary file allocation 

Non-modified cache minimum size 

Number of cache elements (minus 1) that 

can be consumed in a single request 

to the OS 

Size of stack area in bytes used to 

hold the addresses of used cache elements 

( (devcldsmaxcache+2) *4) 

The number of columns in the cache 

The number of cache sectors 

Address of disk cache column table 

Bitmap file's next allocation location 

Fcbbitmap file's next allocation location 

Address of fcb for FCB.SYS 

Address of fcb for ROOODIR.DIR 
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dtdkfcbbitptr 4 

dtdkbitptr 4 

dtdkalocseoqh 4 

dtdkalocfcbqh 4 



Address of fcb for PCBBnMAP.SYS 
Address of fcb for BITMAP. SYS 
Allocate disk queue head 
Allocate fcb queue head 



For NETWORK class devices, the second part of the table is defined as 
follows: 



Name 



Length 

(bytes) Description 



dtnkreadacc 

dtnkreadlock 

dtnkwriteacc 

dtnkwritelock 

dtnkflags 



dtnkwriteqh 
dtnkreadqh 
dtnkhwrite 
dtnkhuninit 



1 The read access count (the number of 

times this device has been opened for 

read access) 
1 The read lock count (the number of 

times this device has been opened with 

read lock) 
1 The write access count (the number of 

times this device has been opened for 

write access) 

1 The write lock count (the number of 
times this device has been opened with 
write lock) 

2 Network class flags. This is a bit encoded 
word. 

Bit Name Bit # Description 
dtnkflvcdriver If set, this is a 

virtual circuit driver 
4 The write access queue header 
4 The read access queue header 
4 Pointer to network layer write routine 
4 Pointer to network layer uninit routine 



For QUEUE 
follows: 



Name 



class devices, the second part of the table is defined as 



Length 

(bytes) Description 



dtqucbptr 



Contains the address of control block page 
which is the communication block between the 
QUEUE class handler and the queue manager 
process 
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dtqufhptr 4 
dtquwriteoper 4 
dtquflags 2 



Contains the address of the queue control 

file header page 

Contains how many write operations have 

been performed on the QUEUE 

QUEUE class flags. Bit encoded word. 

Bit Name Bit # Description 

dtqufldefcrp If set, a default 

create process record 
is defined. A user can 
redirect I/O directly 
to the QUEUE. 

1 If set, the queue 
manager process is to 
remain resident at 
all times. 

2 If set, we are in 
critical code and the 
queue manager process 
cannot die. 

3 If set, the queue is 
marked as closed. No 
new entries may be 
queued. 

4 If set, the queue is 
marked as halted. No 
pending entries will 
be executed. 

5 If set, there are no 
entries in the queue 
control files. 



dtquflqmres 



dtquflqmnodie 



dtquflclosed 



dtquflhalted 



dtquflclean 



The device status is a device class dependent 128 byte table, 
maintained by the device driver for each device. 



It is 



NOTE: The device status table may change with each release of 
the operating system. The current definition is included 
in each release in the file named /SYSINCL.S¥S/ 
DSTATOISP.*. The name of the record included in that file 
is "devicestatus, " i.e., in your program you can declare a 
variable whose type is "devicestatus." 

The device status table is divided into two parts. The first half is 
device independent and is composed of the following fields: 
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Name 



Length 

(bytes) Description 



dsclassid 



dsdriverid 

dsblksz 

dsharderr 

dssofterr 

dsreadoper 

dswriteoper 

dsmaxnumdev 

dscurnumdev 

dsnumtoretry 

dserror reason 

ds reserved 
dsnexttableptr 



2 
2 
2 
2 
4 
4 
2 
2 

2 

4 

32 
4 



The device class. Valid classes are: 
(Note that these names are defined in 
the devtdisp.* files) 
Class Name Value Description 



Character device (ttyspc) 
Character device (tty) 
Tape device (tapespc) 
Tape device (tape) 
Disk device (diskspc) 
Disk device (disk) 
Network dev. (networkspc) 
Network device (network) 
Pipe device (pipespc) 
Pipe device (pipe) 
BSC device (syncspc) 
BCS device (sync) 
Queue device (quespc) 
Queue device (que) 
Non-dev device (nondevspc) 



dtclassttyspc 

dtclasstty 1 

dtclasstapespc 2 

dtclasstape 3 

dtclassdiskspc 4 

dtclassdisk 5 

dtclassnetspc 6 

dtclassnet 7 

dtclasspipespc 8 

dtclasspipe 9 

dtclasssyncspc 10 

dtclasssync 11 

dtclassquespc 12 

dtclassque 13 

dtclassnondevspc 14 

dtclassnondev 15 Non-dev device (nondev) 

The unique id number for this device driver 

Block size of the device (e.g. sector size) 

The hard error count for the device 

The soft error count for the device 

The number of read operations on this device 

The number of write operations on this device 

Maximum # of devices this driver can handle 

Number of devices currently mounted using this 

device driver 

Number of times to retry before reporting a 

hard error 

This contains the haroVare error code for the 

last error received on this device 

Reserved 

Address of next device status table 



The second half of the device status table is device class dependent 
For TAPE class devices the second part is defined as follows: 
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Length 






Name 


(bytes) 
2 


Description 




dstpstatus 


Tape device status. 


A bit encoded word. 






Bit name bit 


# Description 






dstpready 


Set if device ready 






dstpintpend 1 


Set if interrupt 
pending 






dstprewinding 2 


Set if tape rewinding 






dstpbotdetect 3 


Set if device is at 
physical BOT 






dstpeotdetect 4 


Set if device is at 
physical BOT 






dstpwriteprot 5 


Set if tape is write 
protected 


dstpflagsl 


2 


Tape status information. A bit encoded word. 






Bit name bit 


# Description 






dstpdoraw 


0=Read after write 

disabled 

l=Read after write 

enabled 






dstperrintenb 1 


0=Error interrupts are 

enabled 

l=Error interrupts are 

disabled 


dstpspeed 


1 


Tape speed. Values 


are: 






- 


Reserved 






dstpspeedl2ips 1 - 


12 ips 






dstpspeed25ips 2 - 


25 ips 






dstpspeed30ips 3 - 


30 ips 






dstpspeed50ips 4 - 


50 ips 






dstpspeed90ips 5 - 


90 ips 






dstpspeedlOOips 6 - 


100 ips 






dstpspeedl25ips 7 - 


125 ips 


dstpdensity 


1 


Tape density. Values are: 






- 


Reserved 






dstpdens800bpi 1 - 


800 bpi 






dstpdensl600bpi 2 - 


1600 bpi 






dstpdens3200bpi 3 - 


3200 bpi 






dstpdens6250bpi 4 - 


6250 bpi 






dstpdens6400bpi 5 - 


6400 bpi 


dstpiopbcnt 


2 


Number of IOIBs allocated to device 


dstpcachesz 


2 


Number of cache elements allocated to device 


dstpreserved 


46 


Reserved 




dstpuserfield 


8 


User defined status 
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For DISK class devices the second half 
defined as follows: 



of the device status table is 



Name 



dsdkintfac 

dsdkiopbcnt 

dsdknumbsect 

dsdksectrack 

dsdkheads 

dsdkcylinders 

dsdkflagsl 



dsdkcurcyl 

dsdkcachesz 

dsdkentryname 

dsdkreserved 
dsdkuserfield 



Length 

(bytes) Description* 



2 

2 

16 

20 
8 



Disk interleave factor 

Number of IOIB's allocated to the drive 

The number of sectors on the volume 

The number of sectors on a track 

The number of heads on the device 

The number of cylinders on the volume 

Disk status information. A bit encoded word. 

Bit Name Bit # Description 



dsdkdensityl 
dsdkdensity2 1 
dsdkdenssignle 
dsdkdensdouble 
dsdkdensquad 
dsdkdensreserve 
dsdkdoraw 



Device density 



00 - Single density 

01 - Double density 

10 - Quad density 

11 - Reserved 

3 If set, do Read after 
write verify 

4 If set, Device write 
protected 

15 Current seek direction 
- Increasing 
cylinder numbers 
$8000 - Decreasing 
cylinder numbers 
Current cylinder position 
Number of sectors in the disk cache 
A null terminated string containing the name 
of this type of drive 
Reserved 
User Defined status 



dsdkwriteprot 

dsdkseekdir 
dsdkseekincr 

dsdkseekdecr 



For TTX" class devices the second half of the device status table is 
defined as follows: 



Name 



Length 

(bytes) Description 



dstymoderegl 



Uart mode register 1 
encoded as follows: 



This byte is bit 
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dstymodereg2 



Bit Name Bit # 
dstymrlbaudfacl 
dstymrlbaudfac2 1 
dstymrlsyncl 

dstymrlasyncl 

dstymrlasyncl6 

dstymrlasync64 

dstymrlcharlenl 2 
dstymrlcharlen2 3 

dstymrldw5bit 

dstymrldw6bit 

dstymrl6W7bit 

dstymrlcV8bit 
dstymrlparityctrl 4 

dstymrlpardis 

dstymrlparenb 
dstymrlparitytype 5 

dstymrlparodd 

dstymrlparevn 
dstymrlstopbitsl 6 

dstymrlstopbits2 7 

dstymrlbinv 

dstymrlsbl 

dstymrlsbl5 

dstymrlsb2 
dstymrltransctrl 6 

dstymrlnormal 

dstymrl trans 
dstymrlnumsync 7 

dstymrlsyncdouble 

dstymrlsyncsingle 
Uart mode register 2. 
encoded as follows: 
Bit Name Bit # 
dstymr2baudrtl 
dstymr2baudrt2 1 
dstymr2baudrt3 2 
dstymr2baudrt4 3 

dstymr2baud50 

dstymr2baud75 

dstymr2baudll0 

dstymr2baudl345 



Description 
Baud factor 

00 - sync 1 x clock 

rate 

01 - async 1 x clock 

rate 

10 - async 16 x clock 

rate 

11 - async 64 x clock 

rate 
Character length 
definition 
00-5 data bits 
01-6 data bits 
10-7 data bits 
11-8 data bits 
Parity control 

- disable parity 

1 - enable parity 
Parity type 

- odd parity 

1 - even parity 
Async mode # of stop 
bits 

Async mode # of stop 

bits 

00 - invalid 

01-1 stop bit 

10 - 1.5 stop bits 

11-2 stop bits 

Sync mode transparent 

- normal 

1 - transparent 
Sync mode # of syncs 

- double sync 

1 - single sync 
This byte is bit 

Description 
The baud rate 
Baud rate continued 
Baud rate continued 
Baud rate continued 

0000 - 50 baud 

0001 - 75 baud 

0010 - 110 baud 

0011 - 134.5 baud 
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dstycmdreg 



<3stymr2baudl50 

dstymr2baud300 

dstymr2baud600 

dstymr2baudl200 

dstymr2baudl800 

dstymr2baud2000 

dstymr2baud2400 

dstymr2baud3600 

dstymr2baud4800 

<3stymr2baud7200 

dstymr2baud9600 

dstymr2baudl9200 

dstymr2recvclock 4 
dstymr2 r ecextclk 
dstymr2 recintclk 

dstymr2transclock 5 
dstymr2trnextclk 
dstymr2trnintclk 

6-7 

Uart command register. 

Bit Name Bit # 

dstycrtransctrl 
dstycrtcdis 

dstycrtcenb 

dstycrdtr 1 

dstycrdtrhigh 

dstycrdtrlow 
dstycrrecvcrtl 2 

dstycrrcdis 

dstycrrcenb 
dstycrforcebrk 3 

dstycrbrknorm 

dstycrbrkforce 
dstycrsenddle 3 

dstycrdlenorm 

dstycrdlesend 
dstycrreseterror 4 

dstycrnoreset 

dstycrreseterr 
dstycrrts 5 

dstycrrtshigh 

dstycrrtslow 
dstycropermodel 6 



0100 - 150 baud 

0101 - 300 baud 

0110 - 600 baud 

0111 - 1200 baud 

1000 - 1800 baud 

1001 - 2000 baud 

1010 - 2400 baud 

1011 - 3600 baud 

1100 - 4800 baud 

1101 - 7200 baud 

1110 - 9600 baud 

1111 - 19200 baud 
Receiver clock 

- External clock 

1 - Internal clock 
Transmitter clock 

- External clock 

1 - Internal clock 
Reserved 

Bit encoded. 
Description 
Transmitter control 

- Disable 

transmitter 

1 - Enable 

transmitter 
Data terminal ready 

- DTR high 

1 - DTR low 
Receiver control 

- Disable receiver 

1 - Enable receiver 
Async force break 

- normal 

1 - force break 
Sync send DLE 

- normal 

1 - send DLE 
Reset error 

- normal 

1 - reset error 
Request to send 

- RTS high 

1 - RES low 
Operating mode 
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dstycropermode2 7 



dstytermtype 



dstystatreg 



dstycromnormal 

dstycromautoecho 

dstycromstripdle 

dstycromlocallp 

dstycromremotelp 
Terminal type definition, 
values for each type of terminal. 
Value Name Value Description 



Operating mode 
continued 

00 - Normal operation 

01 - Async autoecho 
01 - Sync strip DLE 

10 - Local loop back 

11 - Remote loop back 
This byte contains 



0-15 


User defined types 


16-246 


Reserved 


dstywit 247 


WIT terminal 


dstyhydra 248 


Hydra terminal 


dstyvtlOO 250 


VT-100 terminal 


dstyvt52 251 


VT-52 terminal 


dstyt7000 252 


T-7000 terminal 


dstymg8000 253 


M3-8000 terminal 


dstytvi912c 254 


1VI 912 C terminal 


dstyvisual200 255 


Visual 200 terminal 


Uart status register. 


Bit encoded. 


Bit Name Bit # 


Description 


dstysrtransrdy 


Transmitter buffer 




ready 


dstysrtranfull 


- Transmitter full 


dstysrtranempty 


1 - Transmitter empty 


dstysrrecvrdy 1 


Receiver buffer ready 


dsty sr recvempty 


- Receiver empty 


dstysrrecvfull 


1 - Receiver full 


dstysrdschg 2 


DSR or DCD change 


dstysrdsrnormal 


- Normal 


dsty sr ds r change 


1 - Change in DSR or 




DCD 


dsty srparity err 3 


Parity error 


dstysrparnormal 


- Normal 


dstysrparerror 


1 - Async parity 




error. Sync parity 




error or DLE received 


dstysroverrunerr 4 


Overrun error 


dstysrovernormal 


- Normal 


dsty sr over er ror 


1 - Overrun error 


dstysrframingerr 5 


Framing error 


dsty sr f ramnormal 


- Normal 
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dstypacketterra 



dstyflagsl 



dstysrframerror 


1 - Async framing 






error. Sync SYN 






char 


dstysrdcddetect 


6 


DCD Detect 


dstysrdcdhigh 




- DCD high 


dstysrdcdlow 




1 - DCD low 


dstysrdsrdetect 


7 


DSR Detect 


dstysrdsrhigh 




- DSR high 


dstysrdsrlow 




1 - DSR low 


Holds code for packet 


termination characters 


Value Name 


Value 


Description 


dstyptnoterm 





Do not terminate 
packet on any control 
characters 


dstyptallterm 


1 


Terminate packets on 
all control characters 


dstyptcrterm 


2 


Terminate packet on 
carriage return <CR> 
character 


Terminal status 


information. Bit encoded. 


Bit Name 


bit # 


Description 


dstycontrolc 





Control C enable 
(0 = enabled) 


dstyxonxoff 


1 


xon xoff enable 
(0 = enabled) 


dstycontrolx 


2 


Control X enable 
(0 = enabled) 


dstycontrolz 


3 


Control Z enable 
(0 = enabled) 


dstycontrolo 


4 


Control enable 
(0 = enabled) 


dstytabmap 


5 


Tjab map enable 
(1 = enabled) 


dstymask8bit 


6 


Mask 8th bit enable 
(0 = enabled) 


dstycontrolu 


7 


Control U enable 
(0 = enabled) 


dstybroadcast 


8 


Broadcast enable 
(0 = enabled) 


dstyhandshakel 


9 


Handshaking type 


dstyhandshake2 


10 




dstyhsbell 




00 - No handshake f 
send bell 


dstyhssoft 




01 - Software 
handshake 
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dstyhshard 




10 - HaroVare 










handshake 






dstyhsnone 




11 - No handshake, no 
bell 






dstyduplex 


11 


Full/half duplex 
(0 = full duplex) 






dstymodemctrl 


12 


Modem control enable 
(1 = enabled) 






dstyautobaud 


13 


Auto baud enable 
(1 = enabled) 






dsty remote 


14 


Remote enable 
(1 = enabled) 


dstyinputcnt 


2 


Count of characters 


in input interrupt buffer 


dstyoutptcnt 


2 


Count of characters 


in output interrupt buffer 


dstycolumnpos 


2 


Current column position 


dstyinbufsz 


2 


Input buffer i 


size in bytes 


dstyoutbufsz 


2 


Output buffer 


size in bytes 


dstywidth 


2 


The width of 


the given terminal screen 


dstylength 


2 


The length of 


the given terminal screen 


dstysubreadoper 


4 


Number of sub-read operations 


dstysutwriteoper 


4 


Number of sub-write 


operations 


dsty reserved 


26 


Reserved 






dstyuserfield 


8 


User defined ; 


status 





For PIPE class devices the second part of the device status table is 
defined as follows: 



Name 



Length 

(bytes) Description 



dsppreaderpid 

dsppwriterpid 

dspppipeid 

dsppbuffersz 

dsppbuffercnt 

dsppreadque 

dsppwriteque 

dsppreserved 

dsppuserfield 



4 Process ID of pending reader 

4 Process ID of pending writer 

4 The pipe's ID 

2 The buffer size in bytes 

2 Number of characters in the pipe buffer 

4 Address of read queue 

4 Address of write queue 

32 Reserved 

8 User defined status 



For SYNC class devices the second part of the device status table is 
defined as follows: 
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Length 








Name 


(bytes) 
1 


Description 






dssymoderegl 


Mode register 


1 of the uart (See DSTOODERBS1 






for bit definitions) 




dssymodereg2 


1 


Mode register 


2 of the uart (See DSTXMDDERBG2 






for bit definitions) 




dssycmdreg 


1 


Command register of the uart (See DSTYCMDRBS 






for bit definitions) 




dssytermtype 


1 


Terminal type 


definition. A binary value. 






Value Name 


Value 


Description 




dssyibm3741 


249 


IBM 3741 terminal 






dssyifcm2968 


250 


IBM 2968 terminal 






dssyifcm2770 


251 


IBM 2770 terminal 






dssyifcm3276 


252 


IBM 3276 terminal 






dssyibm3275 


253 


IBM 3275 terminal 






dssyibm2780 


254 


IBM 2780 KJE 






dssyibm3780 


255 


IBM 3780 RJE 


cissy statr eg 


1 


Status register of uart (See DSTySTATRBG 






for bit definitions) 




dssynumbsync 


1 


Number of sync characters to write 


dssyflagsl 


2 


Device Status 


flags. 


Bit encoded. 






Bit Name 


Bit # 


Description 




dssymultipnt 





0=point to point 










l=multipoint 






dssyebcdic 


1 


0=ascii line 
l=ebcdic line 






dssycrcccitt 


2 


0=crc-16 
l=crc-ccitt 






dssylrc 


3 


0=crc (on above types) 
l=lrc 






dssyasctoebcw 


4 


0=no translate on 
write 

l=translate ascii to 
ebcdic on write 






dssyebctoascr 


5 


0=no translate on read 
l=translate ebcdic to 
ascii on read 






dssytranstbl2 


6 


0=translate table 1 
l=translate table 2 


dssyinputcnt 


2 


Number of characters 


in input interrupt 






buffer 






dssyoutputcnt 


2 


Number of characters 


in output interrupt 






buffer 






cissy inbufsz 


2 


Input buffer ; 


size in 


bytes 
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dssyoutbufsz 2 

dssyprevrderr 4 

dss^rwwrerr 4 

dssyprevrdtype 1 



dssynumbtrpad 1 

dssyrecsize 2 

dssyreserved 28 

dssyuserfield 8 



Output buffer size in bytes 

Error from previous un-verif ied read 

Error from previous no-wait write 

Type of previous read 

dssynontran - Non-transparent read 

dssytran - 1 Transparent read 

ttie number of trailing pads to write 

Used in transparent mode with ITBs 

Reserved 

User defined status 



For NETWORK class devices the second part of the device status table is 
defined as follows: 



Name 



Length 
(bytes) 



Description 



dsnkflags 



dsnkwindowsize 

dsnkreserved 

dsnkuserfield 



1 

53 
8 



For NONDEV class devices 
defined as follows: 



Device status flags. Bit encoded. 
Bit Name Bit # Description 
dsnkbyte 0=datagram mode 

l=byte mode 
dsnkmodemctrl 1 0=not enabled 

l=modem Ctrl enabled 
Window size the circuit will use 
Reserved 
User defined status 

the second part of the device status table is 



Name 



Length 
(bytes) 



Description 



dsnduserfield 



64 



For QUEUE class devices 
defined as follows: 



User defined status 
the second part of the device status table is 
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Name 



Length 

(bytes) Description 



dsquassocdev 
dsqusenddev 

dsquformname 
dsqunumexec 
dsqucurnumexec 
dsquflags 



9 
9 

10 
2 
2 
2 



dsqulength 
dsquwidth 
dsqunextentry 
dsqutype 



dsqubaseprior 



dsqureserved 
dsquuserfield 



A null terminated string containing the name 

of the physical printer device 

A null terminated string containing the name 

of the physical device that control messages 

are to be sent to 

A null terminated string containing the 

current form name 

This is the maximum number of entries that 

can execute concurrently 

This is the number of entries that are 

currently active 

Device Status flags. Bit encoded. 

Bit Name Bit # Description 



dsquflupdating 



dsquflqmstay 



dsquflnorestart 



) If set, currently 

updating queue control 
file 
L If set, the queue 

manager process will 
remain running even 
when queue is empty 
I If set, when the queue 

is mounted it does not 
restart jobs in the 
queue 

This holds the length of the forms of the 

printer associated with this queue 

This hold sthe width of the forms of the 

printer associated with this queue 

This is the entry number of the next entry to 

be enqued 

This contains the type of queue this is. The 

values are: 

Value Name Value Description 



dsqutpprint 
dsqutpjob 



20 
8 



1 This is a print type 
queue 

2 This is a job entry 
type queue 

This contains the priority that entries will 

be queued at if they specify the default 

priority 

Reserved 

User defined status 
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Related Privileges: 
None. 



Parameters: 
lun 

dtable 
ldtab 

dstat 
status 

Diagnostics : 
errinvlfn 



- Logical unit number (LUN) of a file on the device whose 
status you wish to receive. 

- Address of a buffer to receive the device table. This 
table must be word aligned. 

- Length of the device table. Up to this many bytes 
of the device table will be transferred to the user 
buffer. 

- Address of a 128 byte buffer to receive the device 
status. 

- Address of a long word to receive the result of 
the operation. 



(132) The logical unit number does not correspond 
to an open file, 
errnoreadpriv (144) The process does not have Read Privilege 

for the file. 



See Also: 



_dismnt 

_getdnam 

_getdst 

_mount 

_setdst 

_siodst 



Dismount a logical device 

Get devicename 

Get device status 

Mount a logical device 

Set device status 

Set device status with LUN 



Assembler Calling Sequence: 

%%sys$disk/sysincl . sys/devtdisp.asm 

%%sys$disk/sysincl . sys/dstatdisp. asm 

push lun ;value - logical unit number 

push dtable ; address - device table 

push ldtab ;value - length of device table 

push dstat ; address - device status 

push status ;address - result of the operation 



jsr _giodst 



;get device status 
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C Function Declaration: 



#include "sys $disk/sysincl . sys/devtdisp. h" 

♦include n sys$disk/sysincl.sys/dstatdisp.h" 

/* get device status with lun*/ 

long /* returns result of the operation */ 

_giodst(lun, dtable, ldtab, dstat) 

long lun; /* logical unit number */ 

devicetable *dtable; /* device table */ 
long ldtab; /* length of device table */ 

devicestatus *dstat; /* device status */ 

FORERAN Subroutine Declaration: 

c I get device status with lun 

subroutine _giodst(lun f dtable , ldtab, dstat, status) 
integer *4 lun 1 logical unit number 
character* (*) dtable 1 device table 
integer*4 ldtab I length of device table 
character* (*) dstat 1 device status 
integer *4 status ! result of the operation 

Pascal Procedure Declaration: 

%%sys$disk/sysincl . sys/devtdisp. pas 
%%sys$disk/sysincl . sys/dstatdisp. pas 

procedure _giodst( {** get device status with lun} 

lun 

dtable 

ldtab 

dstat 
var status 
) ; external ; 



longint; {** logical unit number} 
~array_of_char;{** device table} 
longint; {** length of device table} 
*array_of_char;{** device status} 
longint {** result of the operation} 
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Receive interprocess mail. 
Description: 

Receive a message sent from another process. The message 
may be up to 3952 bytes long and may contain any data. 

Related Privileges: 

none - Allows the process to receive mail addressed to 

itself or to another process with the same owner id 
and group id (uic) as the calling process. 

group - Allows the process to receive mail addressed to 

any process with the same group id as the calling 
process. 

world - Allows the process to receive mail addressed to 
any other process in the system. 

Parameters: 

rpid - Process id of the process whose mail you wish 

to receive. A process id of represents the 

current process. A process id of -1 represents 

the parent of the current process, 
mail - Address of a buffer to receive the message. If 

an error is detected, this buffer is not modified, 
len - Length of the mail buffer in bytes. This 

is the maximum number of characters that can 

be received, 
timout - The maximum time to wait for mail to become available 

for the receiving process. The time out is specified 

in .01 seconds, 
pid - Address of a long word to receive the pid 

of the sender, 
retlen - Address of a long word to receive the length 

of the message that was returned. If an error is 

detected, the value of this long word is set to zero, 
status - Address of a long word to receive the result of 

the operation. 

Diagnostics : 

errinsufpriv (1) The process lacks the privileges required to 

perform the operation, 
errprcsnotfnd (2) The specified process is not in the system 

process table. 

errnomail (20) No interprocess mail, in system message table, 

for the process, 
errtimeout (128) A request was not completed within the 
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specified time. 



See Also: 



_smail - Send interprocess mail 
Assembler Calling Sequence: 
push rpid 



push 


mail 


push 


len 


push 


timout 


push 


pid 


push 


retlen 


push 


status 


jsr 


gmail 



;value - intended receiver 
;address - message buffer 
;value - maximum message length 
; value - time out 
jaddress - senders pid 
jaddress - actual message length 
jaddress - result of the operation 
jreceive interprocess mail 



C function declaration: 



/* receive interprocess mail */ 

long /* returns result of the operation */ 

__gmail (rpid, mail, len, timout, pid, retlen) 

long rpid; /* intended receiver */ 

char mail [3952]; /* message buffer */ 

long len; /* maximum message length */ 

long timout /* time out */ 

long *pid; /* senders pid */ 

long *retlen; /* actual message length */ 

Fortran Subroutine Declaration: 

c ! receive interprocess mail 

subroutine gmail(rpid, mail, len, timout, pid, retlen, status) 



integer*4 rpid 
character*(*) mail 
integer*4 len 
integer*4 timout 
integer*4 pid 
integer*4 retlen 
integer*4 status 

Pascal Procedure Declaration: 



! intended receiver 

! message buffer 

! maximum message length 

! time out 

! senders pid 

! actual message length 

! result of the operation 



procedure __gmail( 

rpid 

mail 

len 

timout 
var pid 
var retlen 
var status 



{** receive interprocess mail} 

longint; {** intended receiver} 

A array__of_char ; {** message buffer} 

longint; {** maximum message length} 

longint; {** time out} 

longint; {** senders pid} 

longint; {** actual message length} 

longint {** result of the operation} 
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); external; 
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hibern 



hibern - Hibernate a process. 

Description: 

Remove a process from consideration by the scheduler. This 
will increment a hibernate ref rence count and set the hibernate 
status bit so the process can no longer be scheduled. There 
are two ways to wake a hibernated process. A call to _wake 
will set the ref rence count to zero and clear the hibernate 
status bit. On the other hand a call to _wakec will decrement 
the hibernate count and clear the hibernate status bit when 
the count goes to zero. A hibernated process will exist 
indefinitely in the process table but in a dormant state until 
either the process is terminated by another process, or is 
awakened by another process. 

Related Privileges: 

none - Allows process to hibernate any process with 

the same owner id and group id (uic) as the calling 

process, 
group - Allows process to hibernate any process with 

the same group id as the calling process, 
world - Allows process to hibernate any process in the 

system. 



Parameters : 



pid 



status 



- Process ID of the process to be hibernated. refers 
to the calling process, -1 refers to the parent of the 
calling process. 

- Address of a long word to receive the result of 
the operation. 



Diagnostics : 

errinsufpriv (1) 
errprcsnotfnd (2) 



The process lacks the privileges required to 
perform the operation. 
The specified process is not in the system 
process table. 



See Also: 

_wait 
_wake 
_wakec 



- Pause for a period of time 

- Wake a hibernated process 

- Wake a hibernated process with count 
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Assembler Calling Sequence: 



push 


pid 


push 


status 


jsr 


Jiibern 



C function declaration: 



long 
Jiibern (pid) 

long pid; 

Fortran Subroutine Declaration: 



subroutine hibern (pid , 
integer*4 pid 
integer* 4 status 

Pascal Procedure Declaration: 

procedure Jiibern ( 

pid : longint; 
var status : longint 
) ;. external; 



; value - process id 

;address - result of the operation 

; hibernate a process 



/* hibernate a process */ 

/* returns result of the operation */ 



/* process id */ 



I hibernate a process 
status) 

! process id 

! result of the operation 



{** hibernate a process} 

{** process id} 

{** result of the operation} 
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Install privileged file. 

Description: 

Allows a process to set the image file privileges on an open file, or 
to establish that a certain file is a device driver. 

If the file is an image file, then when a process is created from 
this image, it will have all of the privileges specified by the 
^install system call, plus whatever privileges were specified by the 
creating (parent) process. 

If a file containing a device driver is installed, then a process can 
mount a device using that driver without having to have operator 
privilege. That is, processes which do not have operator privilege 
cannot mount deviceswith drivers that are not installed. Note that 
the driver file need not be given any privileges. 

If the specified file is already installed, the function performed by 
this system call is to redefine the privileges for the file. No error 
is returned. 

Note that an installed file is identified by the device on which it 
resides and its fcb.seq number. The filename is not used to identify 
the file. That is, loading a new file with the same name as an 
installed file does not install that file. Also, renaming an 
installed file does not affect the fact that the file is installed. 

This operation is valid on any disk file. 

To successfully set file privileges, the calling process must have 
operator privilege, and must have successfully opened the file for 
write access. The calling process can set any privileges that it (the 
process) already has. It must have setpriv privilege to grant more 
privileges than the calling process has. 

Related Privileges: 

none - The process cannot successfully install any file, 
operator - Allows the calling process to install files and to 

grant them any privileges that the calling process has. 
setpriv - If the calling process also has operator privilege, this 

privilege allows the calling process to install files 

and to grant that file any privilege. 
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Parameters: 



siteid 



fname 



priv 



status 



A long word containing the site id of the system on which 
the privileged process is to be installed. A siteid of 
zero corresponds to the system on which the calling 
process is executing. 

Address of a null terminated string containing the 
name of the file whose privileges are to be set. The 
string will be translated automatically by WMCS to its 
logical equivalence. Tftis string may contain up to 93 
significant characters followed by a null. 
The privilege mask contains a bit mask of privileges to 
be given to the file. If the value of this parameter is 
-1, the specified file is given the same privileges as 
the calling process. If the value of this parameter is 
not -1, it represents privileges which are bit encoded 
as follows: 

Bit # Description 



Bit Name 
pcbpvsetpriv 
pcbpvsystem 1 
pcbpvreadphys 2 
pcbpvwritephys 3 
pcbpvsetprior 4 
pcbpvchngsuper 5 
pcbpvbypass 6 
pcbpvoperator 7 
pcbpvaltuic 8 
pcbpvworld 9 
pcbpvgroup 10 
pcbpvnetwork 11 
pcbpvsetattr 12 

13-32 



setpriv 
system 
readphys 
writephys 
setprior 
chngsuper 
bypass 
operator 
altuic 
world 
group 
network 
setattr 
Reserved. 



Must be set to zero. 



Address of a long word to receive the result of the 
operation. 



Diagnostics : 

errinsufpriv 
errinapft 



(1) 



The process lacks the privileges required to 

perform the operation. 
(12) The file type is inappropriate for the given 

operation, 
errnowriteacc (142) The process does not have write-access to the 

specified file, 
errinvcloper (173) The device class is inappropriate for the 

operation. 
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See Also: 



_crproc - Create a new process 
_deinst - Deinstall privileged file 
_getinst - Get installed privileged file 
_mount - Mount a logical device 



Assembler Calling Sequence: 



push 


siteid 


push 


fname 


push 


priv 


push 


status 


jsr 


_install 



C Function Declaration: 



long 

_install (siteid, fname, priv) 

long siteid; 

char fname [94] ; 

long priv; 

FORTRAN Subroutine Declaration: 



;value - system id 

; address - file name 

;value - privilege mask 

; address - result of the operation 

; install privileged file 



/* install privileged file */ 

/* returns result of the operation */ 



/* system id */ 
/* file name */ 
/* privilege mask */ 



1 install privileged file 
subroutine _instal (siteid, fname, priv, status) 
integer*4 siteid 1 system id 
character *94 fname I file name 



integer *4 priv 
integer*4 status 

Pascal Procedure Declaration: 



procedure _install( 



siteid 
fname 
priv 
var status 
) ; external ; 



longint; 
string [931 ; 
longint; 
longint 



privilege mask 

result of the operation 



{** install privileged file) 

{** system id) 

{** file name) 

{** privilege mask) 

{** result of the operation} 
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Close all ksam files. 

Description: 

Close any ksam files that have been opened by the 
current process. Note that this happens automatically 
when the process is deleted. 

Related Privileges: 

None. 

Parameters: 

siteid - A long word containing the system id of the system 
on which all ksam files are to be closed. A siteid 
of zero (0) corresponds to the system on which the 
calling process is executing. 

status - Address of a long word to receive the result of 
the operation 

Diagnostics: 

errnoclass (185) The device class handler was not loaded when 

the system was booted, 
errdevwrtprot (269) The specified device is write-protected. 

Device integrity errors 

See Also: 

__kclose - Close a ksam file 
kopen - Open a ksam file 



Assember calling sequence: 



push 


siteid 


push 


status 


jsr 


kclall 



;value - system id 

;address - result of the operation 

;close all ksam files 



C function declaration: 



long 
__kclall(siteid) 

long siteid; 

Fortran Subroutine Declaration: 



/* close all ksam files */ 

/* returns result of the operation */ 

/* system id */ 



! close all ksam files 
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subroutine kclall(siteid, status) 

integer*4 siteid ! system id 

integer*4 status ! result of the operation 



Pascal Procedure Declaration: 



procedure __kclall( 

siteid : longint; 
var status : longint 
) ; external ; 



{** close all ksam files} 

{** system id} 

{** result of the operation} 
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Close a KSAM file. 

Description: 

This SVC closes a currently open KSAM file (both data and key files) 
that has been opened by the calling process. Any records still locked 
by the closing process are automatically unlocked. 

_KCLOSE writes both the key and data files to disk if the flush flag 
is set. If the flush flag is set on a disk device, all disk cache 
buffers will be written to the device. If the device is a tape, the 
tape buffer is written to the device. 

If the delete mode bit is set, the process must have write privilege 
to the directories containing the data and key files and delete 
privilege to both files for the files to be successfully deleted. 

Related Privileges: 

none - The file will be closed. Allows optional deletion 

of the data and key files if the process has privileges 
as described above. Returns a warning if the process 
specified delete upon closing and does not have the 
required privileges. 

altuic - Allows the process to delete the files upon closing 

if the owner of the image file for the current process 
has privileges to the files as described above. 

bypass - Allows the process to delete the files upon closing 
independent of the process's privileges to the file. 

system - Allows the process to delete the files upon closing 

if the system has privileges to the files as described 
above. 



Parameters: 
lun 
mode 



The logical unit number of the file to be closed, 
lun is obtained from _kopen or _kcreat. 
Bit encoded long word specifying action to be 
taken upon closing. If the bit is zero (0) , no 
action is performed. The following actions apply 
when the specified bit is set to one (1) . 



The 
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clnotruncfile 



status 



Bit Name Bit # Description 

cldelete Delete the data and key files after 

closing. If the file is currently 
open by another process, the actual 
deletion of the files is delayed 
until after all processes have 
closed the files. 
No truncate - Specif ies that when 
the disk file is closed, the 
extra physical sectors allocated 
to the file are not to be released. 
For tape devices, this bit 
specifies that the last block 
written to the tape should be 
written as a full sized block (as 
opposed to a variable sized block) . 
No delete - Overrides the delete 
upon closing request specified by 
the _open system call. 
Forced write - Writes to the 
device all data in system buffers 
associated with this lun. If an 
error occurs it will be reported 
as a warning to the calling 
process. The file is always 
closed. 

Suppress all deletes - Overrides 
all deletes that have been set for 
the file, i.e., opdelete or a 
delete set by a different process. 
Zero delete - Zero each sector of 
the file before deleting the file. 
This bit is only valid if the file 
is being deleted (via cldelete or 
some other way) . 
6-31 Reserved. Must be set to zero. 
- Address of a long word to receive the result of the 
operation. 



clnodelete 



clforcedwrite 



clsupalldelete 4 



clzerodelete 



Diagnostics : 
errinvlfn 
errnodelpriv 



(132) The logical unit number does not correspond to 

an open file. 
(146) The process does not have Delete Privilege for 

the file. 
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errnoclass (185) The device class handler was not loaded when 

the system was booted, 
errdevwrtprot (269) The specified device is write-protected. 

See Also: 

_delete - Delete a file 

Jcclall - Close all KSAM files 

Jccreat - Create a KSAM file 

Jcopen - Open a KSAM file 

Assember Calling Sequence: 



push 


lun 


push 


mode 


push 


status 


jsr 


Jcclose 



C Function Declaration: 



long 

Jcclose (lun, mode) 

long lun; 

long mode; 

FORERAN Subroutine Declaration: 



;value - logical unit number 

; value - mode word 

; address - result of the operation 

;close a KSAM file 



/* close a KSAM file */ 

/* returns result of the operation */ 

/* logical unit number */ 
/* mode word */ 



! close a KSAM file 
subroutine Jcclose (lun, mode, status) 



integer*4 lun 
integer*4 mode 
integer*4 status 

Pascal Procedure Declaration: 

procedure Jcclose ( 

lun : longint; 
mode : longint; 
var status : longint 

) ; external ; 



I logical unit number 

I mode word 

I result of the operation 



{** close a KSAM file) 
{** logical unit number) 
{** mode word) 
{** result of the operation) 
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Create a KSAM file. 

Description: 

This SVC creates new KSAM data and keys files and initializes the key 
files using information provided by the user process. The "current 
key" is set to zero, and the "current record pointer" is undefined 
(the current position pointer is just before the first record in the 
file) as defined by the zeroth key. 

Upon successful completion of _kcreat, the KSAM file is opened and 
the logical unit number is returned. Use the logical unit number for 
all subsequent accesses to the file. 

Unless the process has bypass privilege, it must have read and write 
privilege to the device to contain the files, execute privilege for 
all directories in the path leading to the files, and read and write 
privilege to the directories to contain the files for the file to be 
successfully created. 

NOTE: Each key may be up to 255 bytes long. Word and longword 
keys and key segments must lie on word boundaries (even 
byte) within memory and within the data record. Word keys 
and key segments must be two-byte multiples, and longword 
keys and key segments must be four-byte multiples. 
Assigning either a byte value in a record definition may 
misalign word or longword key fields that follow. You may 
have to offset the other keys to align them on word or 
longword boundaries. 

Related Privileges: 

none - Allows creation if the process has access as described 

above, 
altuic - Allows creation if the owner of the image file for the 

current process has access as described above, 
bypass - Allows the process to create the file independent of the 

file protection, 
system - Allows creation if the system has access as described 

above. 
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Parameters: 
fname 



kfname 



mode 



Address of a null terminated string containing the 
name of the KSAM data file to be created. It may be 
fully qualified with device, directory, file extension 
and version number qualifications. An extension of 
.DAT is recommended. This string will be translated 
automatically by WMCS to its logical equivalent. This 
string may contain up to 93 significant characters 
followed by a null. 

Address of a null terminated string containing the 
name of the KSAM key file to be created. It may be 
fully qualified with device, directory, file extension 
and version number qualifications. An extension of 
.KEY is recommended. This string will be translated 
automatically by WMCS to its logical equivalent. This 
string may contain up to 93 significant characters 
followed by a null. 

A bit mask that specifies the type of access allowed to 
this and other users during the time the KSAM files pair 
is open. The following bits, when set, have the following 
meanings : 
Bit Name Bit # Description 



Read access - Requests permission 

to read the file. 

Write access - Requests permission 

to write the file. 

Read lock - Requests permission 

for exclusive read access to the 

file. Other processes may not 

read the file(s) . 

Write lock - Requests permission 

for exclusive write access to the 

file. Other processes may not 

write the file(s) . 

Delete - Requests that the files 

be deleted upon closing. 

Reserved. 



opreadacc 





opwriteacc 


1 


opreadlock 


2 


opwritelock 


3 


opdelete 


4 




5 
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reel en 



prot 



opfastread 6 Fast read - Specifies that the 

file will be read asynchronously, 
lhat is, that control returns to 
the user process before the data 
have actually been read. As 
records are read, they will be 
transferred directly into the 
process's logical address space 
bypassing the device cache. This 
bit is only valid for disk class 
devices. Other requirements are 
1) Supports only requests for 
complete sectors only, 2) Process 
buffer must be on a word boundary, 
3) Request cannot cross a 4 Kbyte 
page boundary. Use the _f rowait 
system call to determine when 
asynchronous reads are complete. 

7 Open next file - On a tape device, 
specifies to open the "next" file 
without regard to the filename. 

8 No read ahead - Specifies that 
read ahead is not to be done on 
the opened file. 

No truncate - Specifies that when 
the file is closed the extra 
physical sectors allocated to the 
file are not to be released. 

10 Reserved. 

11 Reserved. 

12 Zero delete - Zero each sector of 
the file before deleting the file. 
This bit is only valid if the file 
is being deleted (via cldelete or 
some other way) . 

13-31 Reserved. Must be set to zero. 
Record length. A value that represents the length in 
bytes of each record in the KSAM data file. The record 
length must be in the range of 4 to 65534 bytes 
inclusive. The record size specified by the calling 
process is internally incremented by one to include 
a deletion flag byte. 

File protection mask. The least significant 16 bit 
word of this parameter is divided into 4 nibbles. 
Each nibble corresponds to a class of users. The bits 
within each nibble represent the type of access that 
class of user is granted for this file. If the bit is 
set (1) , the access is granted. 



opnextfile 



opnordahead 



opnotruncfile 9 



opzerodelete 
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From the least to the most significant nibble the user 
classes are: 

(Xmr - file owner 

Grp - processes with the same group ID as the owner 

Pub - all other processes in the system 

Sys - processes with SYSTEM privilege. 

Sys Pub Grp Ownr 

IDWREIDWREIDWREIDWREI 
I 1 



MSB 



LSB 



From the least to the most significant bits within the 
nibbles, the access privileges are: 

E - Execute access 

R - Read access 

W - Write access 

D - Delete access 

The value $FFFFFFFF (-1) is a reserved value that means 
that the user's default protection mask is to be used, 
numbuf - A value that specifies the number of 1-Kbyte buffers to 
allocate for file manipulation. The value supplied is 
used as follows: 

- If the number supplied is zero, the number of 
buffers allocated is four times the number of 
defined keys. 

- If the number supplied is not zero, but is a multiple 
of four, it is used "as is." 

- If the number supplied is not zero and is not 
divisible by four, the number of buffers allocated 
is the number specified, rounded up to the next 
multiple of four. 

In general, at least four buffers per key should be 
available for each key defined in the key definition 
table (see below) . Optimal throughput is achieved by 
allocating sufficient buffers that the top two levels 
of each B-tree can remain in the KSAM cache at all times. 
The number of buffers needed to contain the top two 
levels of any given B-tree is: 

1 + (1006/«key-length>+4)) 

where <key-length> is the length of the key in bytes 
rounded up to an even number. 
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ktable - Address of an array that describes the keys that will be 
used to organize the data file. This table must be word 
aligned. You may define as many keys as you want,* each 
of which can contain up to 15 segments, subject to the 
limitation that the total length of the array may not 
exceed 3500 bytes. Typically, this allows you to define 
more than 300 keys. 

The very first word in the array specifies how many keys 
you are defining. 

NOTE: When you are creating a file, enter the 

number of keys you want to define. When you 
later access this file, refer to the first 
of the keys as key 0. For example, if you 
place a value of 5 in the first word of the 
KTPBLE array, specifying that you want to 
define 5 keys for this file, the keys will 
be designated key 0, key 1, key 2, key 3, 
and key 4. 

The rest of the array contains the definitions of these 
keys. Thus, the array looks like: 



Number of key definitions 



First key definition I 

(4 to 32 words) I 

I 



I Second key definition 
I (4 to 32 words) 

I 
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You must specify at least six pieces of information in 
the key table array for each key. These are: 

- data type 

- number of segments in the key 

- whether duplicate values are allowed in the key 

- the total length of the key in bytes 

- the starting position of each segment of the key 

- the length of each segment of the key 

The length of the key definition is from 4 to 32 words , 
depending on the number of segments defined for the key. 
Each key definition is organized as follows: 

Word of key definition 

This word contains the duplicate key flag bit, the 
data type, and the number of segments in this key. 



I 15 1 14 1 13 1 12 1 11 1 10 1 9 1 8 1 7I6I5I4I3I2I1I0I 
I Reserved iDupl Key type I Number of seg I 



The field positions of these data are: 

Bits 15-8 -Reserved for internal use fcy KSAM. 

See the description of the Jcinfo 

SVC for details. 
Bit 7 -Duplicate key flag. A value of zero 

means that duplicate key values are 

allowed; a value of one means no 

duplicates are allowed. 
Bits 6-4 -Key type. The following are valid 

key types: 

000 8 bit unsigned byte (character) 

001 8 bit signed byte 

010 16 bit unsigned integer 

011 16 bit signed integer (integer) 

100 32 bit unsigned long integer 

101 32 bit signed long integer (long int.) 

110 reserved for future use by WICAT 

111 reserved for future use by WICAT 
Bits 3-0 -Number of segments in the key. This value 

must be between 1 and 15 (inclusive) . 
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Word 1 of key definition 

This word contains the total length of the key in bytes. 
Valid values are from 1 to 255 (inclusive) . 

Word 2 of key definition 

This word contains the starting position within the 
record of the first segment of the key. The first byte 
of the record is designated byte zero. 

Word 3 of key definition 

This word contains the length in bytes of the first 
segment of the key. The length is subject to the 
following restrictions: 

- No key or key segment (of any type) may exceed 255 
bytes in length. 

- Integer key and key segment lengths must be 
multiples of 2. 

- Long integer key and key segment lengths must be 
multiples of 4. 

- Character key and key segment lengths may be any 
value from 1 to 255 characters (inclusive) . 

Words 4 and 5 of key definition 

These words (if present) are of the same format as 
words 2 and 3 but contain information concerning 
segment 2 of the key. 

Words 6 and 7 of key definition 

These words (if present) are of the same format as 
words 2 and 3 but contain information concerning 
segment 3 of the key. 



Words 30 and 31 of key definition 

These words (if present) are of the same format as 
words 2 and 3 but contain information concerning 
segment 15 of the key. 

Example of key definition: 
If a KSAM file is defined as having two keys, the 
first a long word key with 1 segment and the second 
a character key with 4 segments, the key table array 
may look like this: 
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Position Value Meaning 



$2 Number of keys to follow 



Key Definition 

2 $51 Duplicate keys allowed, long word 

key, 1 segment 

3 $4 Total length of key in bytes 

4 $0 Starting position of the key within 

the record 

5 $4 The length of the segment is 4 bytes 

Key 1 Definition 

6 $84 No duplicate keys allowed, character 
key, 4 segments 

Total length of key 1 in bytes 
Starting position of the first segment 
of the key within the record 
Length of first segment of key 
Starting position of the second 
segment of the key within the record 
Length of second segment of key 
Starting position of the third segment 
of the key within the record 
Length of third segment of key 
Starting position of the fourth 

segment of the key within the record 
15 $4 Length of fourth segment of key 



7 


$2A 


8 


$21 


9 


$10 


10 


$4 


11 


$5 


12 


$40 


13 


$11 


14 


$0 



lun 
status 



Note that different key definitions may be created 
from the same portion of the data record. In this 
example, bytes 0-3 of the record are used as the 
first segment of key and the last segment of key 1. 

Address of a long word to receive the logical unit number 

from Jtcreat after successful creation of the file. 

Address of a long word to receive the result of 

the operation. 



Diagnostics : 

errinwernum 
errinvdevnam 
errundevnam 



(129) A file's version number cannot be greater than 
65535. 

(130) The specified devicename is syntactically 
incorrect. 

(131) The MCS does not recognize the devicename. 
Is the device mounted? 
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errfil exists 

errinvreclen 

errnoexecpriv 

errnoreadpriv 

errnowritepriv 

errinvfnstr 

errinvdirfle 
errinvdirstr 

errinvcloper 

errnoclass 

errkeynotinrec 

errkeytablelen 

errnumofkeys 

errnumofsegs 

errrecsz 

errsegalign 

errseglen 

errkeynotfnd 



Dictionary of WMCS System Calls 

Jccreat 



(134) The specified version of the file already 

exists. 
(138) Edit mode 3 requires that the file's record 

length be set to one. 

(143) The process does not have Execute Privilege 
for the file. 

(144) The process does not have Read Privilege for 
the file. 

(145) The process does not have Write Privilege for 
the file. 

(147) The specified filename is syntactically 
incorrect. 

(148) The specified directory is not a directory. 

(149) The specified directory name is syntactically 
incorrect. 

(173) The device class is inappropriate for the 

operation. 
(185) The device class handler was not loaded when 

the system was booted. 

(221) One or more of the KSAM keys is not contained 
in the record. 

(222) The KSAM key definition table is larger than 
3500 bytes. 

(225) The specified number of keys is less than or 
equal to zero. 

(226) The specified number of segments is less than 
or equal to zero. 

(227) The record size is less than 4) bytes or 
greater than 65534) bytes. 

(228) A KSAM key for a word or longword key type is 
not word aligned. 

(229) The specified key length is not a multiple of 
the key- type length. 

(230) Key number is greater than or equal to the 
number of defined keys. 



See Also: 



_delete - Delete a file 
Jcclose - Close a KSAM file 
Jcopen - Open a KSAM file 
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Assembler Calling Sequence: 



push 


fname 


push 


kfname 


push 


mode 


push 


reel en 


push 


prot 


push 


numbuf 


push 


ktable 


push 


lun 


push 


status 


jsr 


_kcreat 


C Function Declaration: 


long 




Jeer eat (fname, kfname, m 




char fname [94] ; 




char kfname [94] ; 




long mode; 




long reel en; 




long prot; 




long numbuf; 




short ktable [x] ; 




long *lun; 



; address - data file name 

; address - key file name 

; value - mode word 

; value - record length 

;value - protection mask 

;value - number of buffers 

; address - key definition table 

; address - logical unit number 

;address - result of the operation 

;create a KSAM file 



/* create a KSAM file */ 
/* returns result of the operation */ 
mode, reclen, prot, numbuf, ktable, lun) 
/* data file name */ 
/* key file name */ 
/* mode word */ 
/* record length */ 
/* protection mask */ 
/* number of buffers */ 
/* where x is the size of the array */ 
/* key table */ 
/* logical unit number */ 



FORTRAN Subroutine Declaration: 

c ! create a KSAM file 

subroutine Jccreat (fname, kfname, mode, reclen, 
& numbuf, ktable, lun, status) 



prot, 



character*94 fname 
character*94 kfname 
integer *4 mode 
integer*4 reclen 
integer*4 prot 
integer *4 numbuf 
integer*2 ktable (x) 

integer*4 lun 
integer *4 status 



! data file name 

! key file name 

! mode word 

I record length 

! protection mask 

I number of buffers 

! where x is the size of the array 

I key table 

! logical unit number 

! result of the operation 
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Pascal Procedure Declaration: 



Dictionary of WMCS System Calls 

Jccreat 



procedure Jccreat ( 



fname : 


i string [93] ; 


kfname : 


5 string [93]; 


mode 5 


longint; 


reclen j 


: longint; 


prot : 


: longint; 


numbuf 


: longint; 


ktable 


: array [0..x] 


var lun 


: longint; 


var status 


: longint 


) ; external ; 





{** create a KSAM file} 
{** data file name) 
{** key file name) 
{** mode word) 
{** record length) 
{** protection mask) 
{** number of buffers) 
_of_integer; {** where x is the size 
{** of the array key table) 
{** logical unit number) 
{** result of the operation) 



KCREAT-11 



_KDELET 

Delete a ksam record. 

Description: 

Jcdelet removes the record pointed to by the "current record pointer" 
from the ksam data file and places a deleted record flag in the 
record. 

Note the following: 

- The current record must be defined by _kread or _kwrite. 

- If the current record has been locked by this process, 
the record is automatically unlocked before it is deleted. 

- After the timeout period expires, if the current record 
is still locked by another process, an error will result. 

- If current record has become undefined because another 
process has deleted the record, an error will result. 

After this call the current record is undefined. 

To successfully delete a record, the process must have opened 
the file with write access. 

Related Privileges: 

None. 

Parameters: 

lun - The logical unit number from _kopen or _kcreat. 
timout - Specifies how long to wait (in units of 0.01 second) 
before returning with a timeout error if the desired 
record is locked by another process. 
== NOTE == 
The process calling _kdelet should check 
for a timeout error and provide code to 
handle this condition, 
status - Address of a long word to receive the result of the 
operation. 



Diagnostics : 
errtimeout 
errinvlfn 



(128) A request was not completed within the 

specified time. 
(132) The logical unit number does not correspond 

to an open file, 
errnowriteacc (142) The process does not have write-access to the 
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errnoclass 
errkeynotdef 
err deadlock 
errreclocked 
errrecnotdef 



specified file, 
(185) The device class handler was not loaded when 

the system was booted. 
(231) This operation requires that the current key 

be defined. 

(234) The specified record cannot be locked without 
causing a deadlock. 

(235) The specified record(s) are locked by another 
process. 

(236) This operation requires that the current 
record be defined. 



See Also: 



_kread - Read a ksam record 

_kupdat - Update an existing ksam record 

_kwrite - Write a new ksam record 



Assembler Calling Sequence: 



push 


lun 


push 


timout 


push 


status 


jsr 


_kdelet 



C Function Declaration: 



long 

Jcdelet (lun, timout) 

long lun; 

long timout; 

FORERAN Subroutine Declaration: 



;value - logical unit number 

; value - time out 

;address - result of the operation 

;delete a ksam record 



/* delete a ksam record */ 

/* returns result of the operation */ 

/* logical unit number */ 
/* time out */ 



! delete a ksam Record 
subroutine kdelet(lun, timout, status) 



integer *4 lun 
integer *4 timout 
integer *4 status 

Pascal Procedure Declaration: 

procedure _kdelet( 

lun : longint; 
timout : longint; 
var status : longint 

); external; 



! logical unit number 

! time out 

I result of the operation 



{** delete a ksam record} 
{** logical unit number} 
{** time out} 
{** result of the operation} 
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_KFIND 
Locate a ksam record. 

Description: 

Finds a record given a key number and the value of a key to 
search for. 

This procedure can change the current key and will leave 
the current record undefined because its associated pointer 
will be left pointing between two records. 

The record following the pointer is either the record that 
was found, or, if the key does not exist, is the record 
that has a key that is alphabetically or numerically greater 
than the key specified to find the desired record. 

Note that "key value not found" error indicates that no 
perfect key match was made, but the current record pointer 
is positioned before the record that is alphabetically or 
numerically greater than the search key. 

When a partial key is used, either a normal status will 
be returned if the record is found that matches the partial 
key or a "key value not found" error will be returned if no 
exact match was found. 

Related Privileges: 

None • 

Parameters: 

lun - The logical unit number from _kopen or _kcreat. 
keynum - The number of the key on which to search. The 

first key specified in the 'ktable' array supplied 

to kcreat is designated key zero, 
keybuf - The address of a buffer containing the value 

of the key or partial key that is used to search 

the file. If the key specified is a word or long word 

key, the buffer must begin on an even byte address 

boundary . 
buflen - The length of the key or partial key in 'keybuf. 

The key length is restricted as follows: 

- All search keys must be less than or equal to 
the length specified at the time the ksam file 
was created. 

- Search keys for character keys may be of any 
length less than or equal to the defined length 
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- Integer search keys must be multiples of two 

- long word integer search keys must be multiples of four 
status - Address of a long word to receive the result of 

the operation. 



Diagnostics: 
errinvlfn 



(132) The logical unit number does not correspond 
to an open file. 



errnoclass 

errseglen 

errkeynotfnd 



(185) The device class handler was not loaded when 
the system was booted. 

(229) The specified key length is not a multiple of 
the key-type length. 

(230) Key number is greater than or equal to the 
number of defined keys. 

errsrchnotfnd (241) An exact match for the specified key value 

was not found. 

See Also: 

_kmovfb - Position to front or back of file 

Asseraber Calling Sequence: 



jvalue - logical unit number 
jvalue - key number 
; address - key value 
jvalue - length of the key 
jaddress - result of the operation 
;locate a ksam record 



push 


lun 


push 


keynum 


push 


keybuf 


push 


buf len 


push 


status 


jsr 


kfind 



C Function Declaration: 



long 



/* locate a ksam record */ 

/* returns result of the operation */ 



kfind (lun, keynum, keybuf, buf len) 



long lun; 

long keynum; 

char *keybuf ; 

long buf len; 

Fortran Subroutine Declaration: 



/* logical unit number */ 

/* key number */ 

/* key value */ 

/* length of the key */ 



! locate a ksam record 
subroutine kfind(lun, keynum, keybuf, buf len, status) 

integer*4 lun ! logical unit number 

integer*4 keynum ! key number 

character* (*) keybuf ! key value 

integer*4 buflen ! length of the key 

integer*4 status ! result of the operation 
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kfind 



Pascal Procedure Declaration: 



procedure _kfind( 

lun : 

keynum : 

keybuf : 

buflen : 

var status : 

) ; external; 



longint ; 
longint ; 
~array__of_char ; 
longint; 
longint 



{** locate a ksam record} 

{** logical unit number} 

{** key number} 

{** key value} 

{** length of the key} 

{** result of the operation} 
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_KFLUSH 

Write modified ksam buffers. 

Description: 

Flushes (writes) all currently unused ksam buffers to the 
file management system. _kflush is also executed by a call 
to the regular file system SVC __flush. 

Related Privileges: 

None. 

Parameters : 

siteid - A long word containing the system id number of the 

system whose ksam buffers are to be flushed. A siteid 
of zero correponds to the system on which the calling 
process is executing. 

status - Address of a long word to receive the result of the 
operation. 

Diagnostics : 

errinvsiteid (8) The specified site id does not exist, 
errnoclass (185) The device class handler was not loaded when 

the system was booted. 

See Also: 

_flush - Flush I/O buffers to the device 

Assembler Calling Sequence: 

;value - system id 

jaddress - result of the operation 

;write modified ksam buffers 

C Function Declaration: 

/* write modified ksam buffers */ 

long /* returns result of the operation */ 

Jkflush(siteid) 

long siteid; /* system id */ 

Fortran Subroutine Declaration: 

c ! write modified ksam buffers 

subroutine kf lush(siteid, status) 

integer*4 siteid ! system id 

KFLUSH-1 



push 


siteid 


push 


status 


jsr 


kflush 



Dictionary of MCS System Calls 
kflush 



integer*4 status 
Pascal Procedure Declaration: 

procedure _kflush ( 

siteid : longint; 
var status : longint 
) ; external ; 



! result of the operation 



{** write modified ksam buffers} 

{** system id} 

{** result of the operation } 
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JQNFO 

Retrieve ksam information file. 

Description: 

Provides the user program with information about a ksam file. 
It allows a program to work with a ksam file without 
knowing its attributes when it opens the file. For 
example, a process accessing a file it did not create can 
use __kinfo to obtain the information it needs to use the file. 

_kinfo returns information about the keys in the keys file, 
the data records in the data file and identifies the last 
operation performed on the file. 

Related Privileges: 

None. 

Parameters: 

lun - The logical unit number from _kopen or _kcreat. 

option - A value that describes what information is desired. 
The values that can be passed to the routine through 
this parameter and what information they will cause 
the routine to return are described below. 

Negative Integer - Any negative integer for this 
parameter causes _kinfo to copy information into 
a 28-byte block of memory starting at the address 
specified by 'ktable'. The format of this block is: 

Long word - Contains the size of the data record 
as defined in the call to __kcreat. 

Long word 1 - Contains the number of active data 
records in the KSAM data file. 

Long word 2 - Contains the number of inactive data 
records in the KSAM data file. 

Long word 3 - Contains the number of active key 
blocks in the KSAM key file. 

Long word 4 - Contains the number of inactive key 
blocks in the KSAM key file. 

Long word 5 - Contains the number of keys defined 
in the file. 
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Long word 6 - Contains a function code which 
represents the last successfully completed KSAM 
function call. The function code can assume the 
following values: 






kcreat 


1 

2 


kopen 
kread 


3 


kwrite 


4 
5 


kupdat 
kdelet 


6 


kfind 


7 


kmovfb 


8 


kinfo 


9 


kunlck 


10 


kflush 



Key Number - A positive integer or zero for this value 
is interpreted as a key number. From 8 to 64 bytes of 
information (depending on the number of segments defined 
for this key) are copied into memory beginning at ktable. 
This information is identical to the information in the 
key table array passed to _kcreat for the specified key 
except for the high order byte of word 0, which contains 
the number of levels currently in use in the B-tree for 
this key. The format of this array is: 

Word - Contains the number of levels currently in use 
in the B-tree, the duplicate key flag bit, the data type, 
and the number of segments in this key. 



15 |14 |13 |12 111 |10 | 9 | 8 | 7 | 6 | 5 | 4 | 3 | 2 | 1 | | 
Number of levels |Dup| Key type | Number of seg | 



The field positions of these data are: 

Bits 15-8 - Contains the number of levels currently 
in use in the B-tree for this key. 

Bit 7 - Duplicate key flag. A value of zero means 

that duplicate key values are allowed; a value of one 
means no duplicates are allowed. 

Bits 6-4 - Key type. The following are valid key 
types : 

000 - 8-bit unsigned byte (character) 

001 - 8-bit signed byte 

010 - 16-bit unsigned integer 
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Oil - 16-bit signed integer (integer) 

100 - 32-bit unsigned long integer 

101 - 32-bit signed long integer (long integer) 

110 - reserved for future use by WICAT 

111 - reserved for future use by WICAT 

Bits 3-0 - Number of segments in the key. This value 
must be between 1 and 15 (inclusive). 

Word 1 - Contains the total length of the key in bytes. 
Valid values are from 1 to 255 (inclusive). 

Word 2 - Contains the starting position within the record 
of the first segment of the key. The first byte of the 
record is designated byte zero (0). 

Word 3 - Contains the length in bytes of the first 

segment of the key. The length is subject to the 
following restrictions: 

- No key or key segment (of any kind) may exceed 
255 bytes. 

- Integer key and key segment lengths must be 
multiples of two. 

- Long integer key and key segment lengths must be 
multiples of four. 

- Character key and key segment lengths may be any 

value from 1 to 255 characters (inclusive). 

Words 4 and 5 - These words (if present) are of the same 
format as words 2 and 3 but contain information concerning 
segment two of the key. 

Words 6 and 7 - These words (if present) are of the same 
format as words 2 and 3 but contain information concerning 
segment three of the key. 



Words 30 and 31 - These words (if present) are of the same 
format as words 2 and 3 but contain information concerning 
segment 15 of the key. 

ktable - Address at which the information returned by this call 

will be placed. Twenty-eight bytes are required if option 
is a negative number, and from 8 to 64 bytes are required 
to copy the key table for a specified key. 
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status - Address of a long word to receive the result of 
the operation. 



Diagnostics: 
errinvlfn 

errnoclass 
errkeynotfnd 



(132) The logical unit number does not correspond 

to an open file. 
(185) The device class handler was not loaded when 

the system was booted. 
(230) Key number is greater than or equal to the 

number of defined keys. 



See Also: 

_kcreat - Create a ksam file 
Assember Calling Sequence: 



push 


lun 


push 


option 


push 


ktable 


push 


status 


jsr 


kinfo 



C Function Declaration: 



long 

_kinfo(lun, option, ktable) 

long lun; 

long option; 

char *ktable; 

Fortran Subroutine Declaration: 



jvalue - logical unit number 
;value - function code 
jaddress - returned data 
jaddress - result of the operation 
jretrieve ksam file information 



/* retrieve ksam file information */ 
/* returns result of the operation '-/ 

/* logical unit number 
/* function code */ 
/* returned data */ 



! retrieve ksam file information 
subroutine kinfo(lun, option, ktable, status) 



integer*4 lun 
integer*4 option 

character*(*) ktable 
integer*4 status 



Pascal Procedure Declaration: 



procedure _kinfo( 
lun 

option 

ktable 

var status 

) ; external; 



! logical unit number 

! function code 

! returned data 

! result of the operation 



{** retrieve ksam file information} 



longint; {** logical unit number} 

longint; {** function code} 

A array_of_char ; {** returned data} 

longint {** result of the operation} 
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_KMOVFB 
Position to front or back of file. 
Description: 

Allows the user program to position the current record 

pointer to just after the last record or just before the 
first record in the file for the specified key. After 
a call to _kmovfb, the current record is undefined. 

- If a forward read is executed immediately after a move 
to back of file request is performed, an end-of-file 
condition would be encountered. 

- The same is true if a reverse read is executed immediately 
after a move to the front request is performed. 

- A "read current record" performed after either of these 
calls would result in a "Current record is undefined" error 

_kmovfb makes it easy for a program to read a KSAM file 
sequentially in either direction. 

_kmovfb sets the "current key" to the key number specified 
in the call. 

Related Privileges: 
None. 



Parameters : 

lun 
keynum 

mode 

status 



- The logical unit number from _kopen or __kcreat. 

- The number of the key for which the current record 
pointer is positioned to the beginning-of-file or 
end-of-file. The first key defined is key 0. 

- Specifies the direction of the move. Zero means 
move to the beginning of the file. Non-zero means 
move to the end of the file. 

- Address of a long word to receive the result of the 
operation. 



Diagnostics: 
errinvlfn 
errnoclass 
errkeynotfnd 



(132) The logical unit number does not correspond 

to an open file. 
(185) The device class handler was not loaded when 

the system was booted. 
(230) Key number is greater than or equal to the 

number of defined keys. 
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See Also: 

__kfind - Locate a ksam record 
_kread - Read a ksam record 

Assembler Calling Sequence: 



push 


lun 


push 


keynum 


push 


mode 


push 


status 


jsr 


kmovfb 



;value - logical unit number 

;value - key number 

;value - mode word 

jaddress - result of the operation 

jposition to front or back of file 



C Function Declaration: 



long 

__kmovfb(lun, keynum, mode) 

long lun; 

long keynum; 

long mode ; 

Fortran Subroutine Declaration: 



/* position to front or back of file */ 
/* returns result of the operation */ 

/* logical unit number */ 
/* key number */ 
/* mode word */ 



! position to front or back of fil 

subroutine kmovfb(lun, keynum, mode, status) 

integer*4 lun ! logical unit number 

integer*4 keynum ! key number 

integer*4 mode ! mode word 

integer*4 status ! result of the operation 



Pascal Procedure Declaration: 



procedure kmovfb( 



lun 

keynum 
mode 
var status 
) ; external; 



: longint; 
: longint; 
: longint; 
: longint 



{** position to front or back of file} 

{** logical unit number} 

{** key number} 

{** mode} 

{** result of the operation} 
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KOPEN 



Open a KSAM file. 
Description: 



_JCOPEN opens one KSAM file (consisting of a data and a key file) with 
the given names and positions the file at the beginning-of-file for 
the first key (key 0) . Hie current key is set to zero, and the the 
current record pointer is undefined (the current position pointer is 
just in front of the first record in the file) as defined by the 
zeroth key. 

Unless the process has bypass privilege, it must have read/write 
privilege to the device (s) containing the files, execute privilege to 
all directories in the path leading to the files, read privilege to 
the directory containing the files, and read/write privilege to the 
files themselves in order for the files to be successfully opened. 

If fname (or kfname) is specified in fcb.seq number format, the 
process must have read/write privilege to the device (s) containing 
the files, and read/write privilege to the files themselves in order 
for the files to be successfully opened. 



Related Privileges: 



none 
altuic 



bypass 
system 



- Allows opening if the process has access to the 
files as described above. 

- Allows opening if the owner of the image file 
for the current process has access to the files 
as described above. 

- Allows opening independent of file protection. 

- Allows opening if the system has access to the 
files as described above. 



Parameters: 
fname 



- Address of a null terminated string containing the 
name of the KSAM data file to be opened. This string 
will be translated automatically by the MCS into its 
logical equivalence. This string may contain up to 93 
valid characters followed by a null. 
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kfname 



mode 



Bit Name 
opreadacc 

opwriteacc 

opreadlock 

opwritelock 

opdelete 

opfastread 



Bit 




Address of a null terminated string containing the 
name of the KSAM key file to be opened- This string 
will be translated automatically by the MCS into its 
logical equivalent. This string may contain up to 93 
valid characters followed by a null. 
A bit encoded mask that specifies the access allowed 
to this and other users during the time the KSAM files 
pair is open. The following bits, when set, mean the 
following: 

Description 
Read - Current process is allowed 
read access 

Write - Current process is allowed 
write access 

Read lock - Other processes may not 
read the file(s) 

Write lock - Other processes may not 
write the file(s) 
Delete the file when closed 
Reserved. 

Fast read - Specifies that the 
file will be read asynchronously. 
Hiat is, that control returns to 
the user process before the data 
have actually been read. As 
records are read, they will be 
transferred directly into the 
process's logical address space 
bypassing the device cache. This 
bit is only valid for disk class 
devices. Other requirements are 
1) Supports only requests for 
complete sectors only, 2) Process 
buffer must be on a word boundary/ 
3) Request cannot cross a 4 Kbyte 
page boundary. Use the _frcwait 
system call to determine when 
asynchronous reads are complete. 
Open next file - On a tape device, 
specifies to open the "next" file 
without regard to the filename. 
No read ahead - Specifies that 
read ahead is not to be done on 
the opened file. 

No truncate - Specif ies that when 
the file is closed the extra 
physical sectors allocated to the 
file are not to be released. 



opnextfile 



opnordahead 8 



opnotruncfile 9 
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Jcopen 



numbuf 



lun 
status 

Diagnostics: 



10 Reserved. Must be set to zero. 

11 Reserved. Must be set to zero, 
opzerodelete 12 Zero delete - Zero each sector of 

the file before deleting the file. 

This bit is only valid if the file 

is being deleted (via cldelete or 

some other way) . 
13-31 Reserved. Must be set to zero. 
A value that specifies the number of IK buffers 
to allocate for file manipulation. The value supplied 
is used as follows: 

- If the number supplied is zero, the number of buffers 
allocated is four times the number of defined keys. 

- If the number supplied is not zero, but is a multiple 
of four, it is used "as is". 

- If the number supplied is not zero and is not 
divisible by four, the number of buffers allocated is 
the number specified rounded up to the next multiple 
of four. 

In general, at least four buffers per key should be 
available for each key defined in the key definition 
table (see below) . Optimal throughput is achieved 
by allocating sufficient buffers that the top two 
levels of each B-tree can remain in the KSAM cache 
at all times. Hie number of buffers needed to contain 
the top two levels of any given B-tree is: 

1 + (1006/(<key-length>44)) 

where <key-length> is the length of the key in bytes, 
rounded up to an even number. 
Address of the variable that will contain the 
logical unit number of the successfully opened file. 
Address of a long word to receive the result of 
the operation. 



errnomemavail (7) 

errinvdevnam (130) 

er rundevnam (131) 

errfilnotfnd (133) 

errnoexecpriv (143) 



All available memory has been allocated. 

The specified devicename is syntactically 

incorrect. 

The MCS does not recognize the devicename. 

Is the device mounted? 

The specified file could not be found. 

The process does not have Execute Privilege 

for the file. 
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errnoreadpriv 
errnowritepriv 

errinvfnstr 

errinvdirfle 

errinvdirstr 



(144) The process does not have Read Privilege 
for the file. 

(145) The process does not have Write Privilege 
for the file. 

The specified filename is syntactically incorrect. 
The specified directory is not a directory. 
The specified directory name is syntactically 
incorrect. 

errinvcloper (173) The device class is inappropriate for the 

operation. 

The specified directory does not exist. 
The file's PCB.SBQ number in the directory 
file is incorrect. 

The device class handler was not loaded when 
the system was booted. 



errdirnotfnd 
errinvseqnum 

errnoclass 



(147) 
(148) 
(149) 



(177) 
(178) 

(185) 



See Also: 

Jcclall - Close all KSAM files 
Jcclose - Close a KSAM file 
Jeer eat - Create a KSAM file 

Assembler Calling Sequence: 



push 


fname 


push 


kfname 


push 


mode 


push 


numbuf 


push 


lun 


push 


status 


jsr 


Jcopen 



;address - data file name 

;address - key file name 

;value - mode word 

; value - number of buffers 

; address - logical unit number 

; address - result of the operation 

;open a KSAM file 



C Function Declaration: 



/* open a KSAM file */ 
long /* returns result of the operation */ 

Jcopen (fname, kfname, mode, numbuf, lun) 

char fname [94] ; /* data file name */ 
char kfname [94]; /* key file name */ 
long mode; /* mode word */ 

long numbuf; /* number of buffers */ 
long *lun; /* logical unit number */ 
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_kopen 



FORTRAN Subroutine Declaration: 



1 open a KSAM file 
subroutine _Jcopen( fname f kfname f mode, numbuf , lun f status) 
character*94 fname 1 data file name 
character *94 kfname I key file name 



integer *4 mode 
integer *4 numbuf 
integer *4 lun 
integer *4 status 

Pascal Procedure Declaration: 



procedure _kopen( 
fname 
kfname 
mode 
numbuf 
var lun 
var status 
) ; external ; 



string [93] ; 

string [93] ; 

longint; 

longint; 

longint; 

longint 



I mode word 

1 number of buffers 

! logical unit number 

I result of the operation 



{** open a KSAM file} 

{** data file name) 

{** key file name) 

{** mode) 

{** number of buffers) 

{** logical unit number) 

{** result of the operation) 
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Read a ksam record. 

Description: 

Jcread reads the next, current, or previous (as defined by the 
"current key" and "current record") record from the KSAM file into 
the user process's buffer. If the read is successful, the record 
that is read becomes the "current record". 

This routine reads the file sequentially forwards/backwards, in 
ascending/descending order, alphabetically, or numerically. 

If the "lock bit" (see below under OPTION) is set, the specified 
record will be write locked before _kread reads the record into the 
buffer. If the record has been previously locked ty another process, 
Jcread waits until the TIMXJT period expires before returning with a 
timeout error. (If the file becomes unlocked before the TIMXJT 
period expires, the read continues normally and no error occurs.) 
The data transfer inhibit bit allows the file pointers to be moved 
without actually transferring data. 

Deadlock detection is performed on the record to be read. If no 
deadlock is detected but the record is locked, the process will wait 
until the record can be successfully locked or until the TIMDUT 
period has expired. 

After the record is read, the key value found in the key file is 
typically compared to the key found within the data just transferred. 
Use the "key compare inhibit" bit in OPTION to inhibit this 
comparison. 

Related Privileges: 

None. 

Parameters: 

lun - The logical unit number from _ kopen or Jccreat. 

option - A bitmask that specifies options to be used 
for this call to Jcread. The bit fields are: 
Bits 0-3 - Specifies which record to read, as follows: 

0000 - Read current record ("current record" must 

be defined) 

0001 - Read next (ascending) record 

0010 - Read previous (descending) record 

0011 to 1111 - Reserved 
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Bit 4 - Lock Request Bit. If this bit equals one f 
write lock the record before reading. If the record 
is already locked, the lock request will be queued 
until it can be granted or until the TIM3UT period 
expires. 

Bit 5 - Key Compare Inhibit. If bit five is zero, 
the key from the key file is compared to the key 
constructed from the data just read. If the two 
disagree, an error is returned. A key compare error 
indicates that the key file now disagrees with the 
data file and that the key file should be rebuilt. 
If this bit is one, no keys are compared. KSAM 
ignores this bit when the data transfer inhibit bit 
is set. 

Bit 6 - Data Transfer Inhibit Bit. When 0, data 
transfers are done. If set to 1, pointers are updated, 
but no actual data transfer occurs. KSAM ignores the 
compare inhibit bit if this bit is set. 

Bits 7 to 31 Reserved (Must be set to zeros (0)). 

timout - Specifies how long to wait for successful completion 
before returning with a timeout error if the desired 
record is locked by another process, timout is 
specified in 0.01 of a second. 

== NOTE == 
The process calling _kread should check 
for a timeout error and provide code to 
handle this condition. 

buf - Address of a buffer into which the data 

record from the ksam file can be read. The buffer 
must be large enough to contain the entire record 
because the entire data record is transferred. 

status - Address of a long word to receive the result of 
the operation. 

Diagnostics : 

errnomemavail (7) All available memory has been allocated, 
errtimeout (128) A request was not completed within the 

specified time, 
errinvlfn (132) The logical unit number does not correspond to 

an open file, 
errreadleof (140) The process tried to read past the logical end 
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errnoreadacc 
er mod ass 
errkeynotdef 
errdeadlock 
err reel ocked 
errrecnotdef 



of a file. 
(141) The process does not have read-access to the 

file. 
(185) The device class handler was not loaded when 

the system was booted. 
(231) This operation requires that the current key 

be defined. 

(234) The specified record cannot be locked without 
causing a deadlock. 

(235) The specified record (s) are locked by another 
process. 

(236) This operation requires that the current record 
be defined. 



See Also: 



Jcdelet - Delete a ksam record 
Jcf ind - Locate a ksam record 
Janovfb - Position to front or back of file 
Jcunlck - Unlock specified ksam records 
Jaipdat - Update an existing ksam record 
kwrite - Write a new ksam record 



Assembler calling sequence: 



push 


lun 


push 


option 


push 


timout 


push 


buf 


push 


status 


jsr 


Jcread 



C Function Declaration: 



long 

_kread(lun, option, timout, buf) 

long lun; 

long option; 

long timout; 

char *buf ; 

Fortran Subroutine Declaration: 



;value - logical unit number 

;value - mode word 

; value - time out 

;address - read buffer 

;address - result of the operation 

;read a ksam record 



/* read a ksam record */ 

/* returns result of the operation */ 

/* logical unit number */ 
/* mode word */ 
/* time out */ 
/* read buffer */ 



! read a ksam record 
subroutine kread(lun, option, timout, buf, status) 
integer*4 lun I logical unit number 
integer*4 option I mode word 
integer *4 timout ! time out 



KREAD-3 



Dictionary of WMCS System Calls 
_kread 

character* (*) buf 
integer*4 status 

Pascal Procedure Declaration: 



I read buffer 

! result of the operation 



procedure _Jcread( 
lun 

option 
timout 
buf 
var status 

) ; external ; 



{** read a ksam record} 
longint; {** logical unit number} 
longint; {** mode} 
longint; {** time out 
~array_of__char; {** read buffer} 
longint {** result of the operation} 
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Unlock specified ksam records. 

Description: 

Unlocks the current record or unlocks all records locked 
on the lun specified. If the records specified are already 
unlocked, nothing happens, and no error is returned. 

Related Privileges: 

None. 
Parameters: 

lun - The logical unit number from _kopen or _jkcreat. 

option - Specifies the action to be taken. Only bit is 
currently used. If bit is zero, the current 
record is unlocked. If bit is one, all records 
locked by the given LUN are unlocked. 

status - Address of a long word to receive the result of the 
operation. 



Diagnostics : 
errinvlfn 
errnoclass 
errkeynotdef 
errksamnorec 

See Also: 



(132) The logical unit number does not correspond 

to an open file. 
(185) The device class handler was not loaded when 

the system was booted. 
(231) This operation requires that the current key 

be defined. 
(237) The specified record(s) is not locked. 



__kread - Read a ksam record 

_kupdat - Update an existing ksam record 

__kwrite - Write a new ksam record 

Assembler Calling Sequence: 



push 


lun 


push 


option 


push 


status 


jsr 


kunlck 



C function Declaration: 



long 



;value - logical unit number 

jvalue - option 

jaddress - result of the operation 

;Unlock specified ksam records 



/* unlock specified ksam records */ 
/* returns result of the operation */ 
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kunlck(lun, option) 
long lun ; 
long option; 

Fortran Subroutine Declaration: 



/* logical unit number */ 
/* option */ 



! unlock specified ksam records 
subroutine kunlck(lun, option, status) 

integer*4 lun ! logical unit number 

integer*4 option ! option 

integer*4 status ! result of the operation 



Pascal Procedure Declaration: 

procedure _kunlck( 

lun : longint; 

option : longint; 
var status : longint 
) ; external; 



{** unlock specified ksam records} 

{** logical unit number} 

{** option} 

{** result of the operation} 
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Update an existing ksam record. 

Description: 

Updates the record that is pointed to by "current record". It allows 
a program to change a record that has already been written to the 
ksam file. If the value of any of the keys is changed, the key in 
the keys file is changed to reflect the new key value. 

Any key may be updated, however, if a key is defined as disallowing 
duplicate values and the value of the key has changed, the new value 
is checked to see if it is already in the file. If it is, then the 
record is not updated, and an error results. 

Records that are locked fcy another process (or by the same process 
under another LUN) may not be updated until they are unlocked. If the 
record is locked, the SVC will wait up to the value supplied in 
timout before returning with a timeout error. 

Related Privileges: 

None. 



Parameters: 

lun 
timout 



The logical unit number from _kopen or _kcreat. 
Specifies how long to wait (in 0.01 of a second) 
before returning with a timeout error if the 
desired record is locked by another process. 

=== NOTE === 
The process calling _kupdat should check 
for a timeout error and provide code to 
handle this condition. 



buf - The address of a buffer from which the data 

record is written to the KSAM file. The buffer 
must be large enough to contain the entire record 
because the entire data record is transferred. 

status - Address of a long word to receive the result of 
the operation. 

Diagnostics : 



er rnomemavail ( 7 ) 
errtimeout (128) 



All available memory has been allocated, 
A request was not completed within the 
specified time. 
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errinvlfn (132) The logical unit number does not correspond 

to an open file, 
errnowriteacc (142) The process does not have write-access to 

the specified file. 
(154) All available disk space has been allocated. 
(173) The device class is inappropriate for the 

operation. 
(185) The device class handler was not loaded when 
the system was booted. 

(231) This operation requires that the current key 
be defined. 

(232) Duplicate key was attempted in a field 
disallowing duplicate keys. 

(234) The specified record cannot be locked without 
causing a deadlock. 

(235) The specified record (s) are locked by another 
process. 

(236) This operation requires that the current 
record be defined. 
Device integrity error 



errnospace 
errinvcloper 

errnoclass 

errkeynotdef 

errnodupkey 

errdeadLock 

errreclocked 

errrecnotdef 



See Also: 

Jcdelet - Delete a ksam record 
Jcread - Read a ksam record 
Jumlck - Unlock specified ksam records 
_kwrite - Write a new ksam record 

Assembler Calling Sequence: 



push 


lun 


push 


timout 


push 


buf 


push 


status 


jsr 


Jcupdat 



; value - logical unit number 

; value - time out 

;address - record to update 

;address - result of the operation 

; update an existing ksam record 



C Function Declaration: 



long 

Jcupdat ( lun , timout , buf) 

long lun; 

long timout; 

char *buf ; 

Fortran Subroutine Declaration: 



/* update an existing ksam record */ 
/* returns result of the operation */ 

/* logical unit number */ 

/* time out */ 

/* record to update */ 



1 update an existing ksam record 
subroutine kupdat(lun r timout , buf, status) 
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integer *4 lun 
integer *4 timout 
character *(*) buf 
integer *4 status 

Pascal Procedure Declaration: 



I logical unit number 

1 time out 

I record to update 

1 result of the operation 



procedure _kupdat( 



lun 


: longint; 


timout 


: longint; 


buf 


: ~array_jof_char; 


var status 


: longint 


); external; 





{** update an existing ksam record} 

{** logical unit number} 

{** time out} 

{** record to update} 

{** result of the operation} 
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Write a new ksam record. 

Description: 

Writes a record to the ksam file. Upon successful completion, the 
record becomes the current record. If a key is defined as 
disallowing duplicate values, KWKETE checks to see if the key values 
are already in the file. If so, then the record is not written, and 
an error results. 

Related Privileges: 

None. 



Parameters: 

lun 
timout 



buf 
status 

Diagnostics: 



- The logical unit number from _kopen or _kcreat. 

- Specifies how long to wait (in 0.01 of a second) 
before returning with a timeout error if the write 
is unsuccessful. 

== Note = 
The process calling _kwrite should check 
for a timeout error and provide code to 
handle this condition. 

- Contains the address of a buffer from which the 
data record is written to the KSAM file. 

- Address of a long word to receive the result of 
the operation. 



errnomemavail (7) 

errtimeout (128) 

errinvlfn (132) 

er mow r i teacc ( 142 ) 

errnospace (154) 

errinvcloper (173) 

errnoclass (185) 

errnodupkey (232) 

errdeadlock (234) 



All available memory has been allocated. 

A request was not completed within the specified 

time. 

The logical unit number does not correspond to 

an open file. 

The process does not have w rite-access to the 

specified file. 

All available disk space has been allocated. 

The device class is inappropriate for the 

operation. 

The device class handler was not loaded when 

the system was booted. 

Duplicate key was attempted in a field 

disallowing duplicate keys. 

The specified record cannot be locked without 
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causing a deadlock, 
errreclocked (235) The specified record(s) are locked by another 

process, 
errrecnotdef (236) This operation requires that the current record 

be defined. 

Device integrity error 

See Also: 

Jcdelet - Delete a ksam record 
Jcread - Read a ksam record 
Jainlck - Unlock specified ksam records 
_kwrite - Write a new ksam record 

Assember Calling Sequence: 



push 


lun 


push 


timout 


push 


buf 


push 


status 


jsr 


_kwrite 



; value - logical unit number 

; value - time out 

;address - record to be written 

;address - result of the operation 

;write a new ksam record 



C Function Declaration: 



long 

_kwrite(lun, timout, buf) 

long lun; 

long timout; 

char *buf; 

Fortran Subroutine Declaration: 



/* write a new ksam record */ 

/* returns result of the operation */ 

/* logical unit number */ 

/* time out */ 

/* record to be written */ 



I write a new ksam record 
subroutine kw rite (lun, timout, buf, status) 

integer*4 lun I logical unit number 
integer*4 timout I time out 
character* (*) buf 1 record to be written 
integer*4 status I result of the operation 



Pascal Procedure Declaration: 
procedure _kwrite( 



lun 


: longint; 


timout 


: longint; 


buf 


: ~array_pf_char; 


var status 


: longint 


); external; 





{** write a new ksam record} 
{** logical unit number} 
{** time out} 
{** record to be written} 
{** result of the operation} 
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Lock records within an open file. 

Description: 

__lock is a mechanism which will allow multiple processes 
to successfully have read and/or write access to the same 
file without interfering with one another. It provides 
controlled access to specified records within an open file. 
When a process locks one or more records, those records 
are not accessible to other processes in the system. 
Other processes which attempt to lock, read or write the 
locked area will be suspended with an I/O wait until the 
area is unlocked, or until the timout is exceeded. Deadlocks 
are detected and if found, control is returned to the calling 
process immediately. 

The process can lock a group of records and then later 
unlock specific records within the group. A process can 
lock records that are beyond the logical end of file. 

All types of files can be locked (including user defined file 
types, and system files). Note, however, that the Operating 
system does not check for locked records when it is updating 
system file (bitmap, fcb, directories). Records may only be 
locked on disk class devices. 

Note that named semaphores may be implemented by creating 
files which are only manipulated by locks. One file is 
capable of containing a large number of semaphores. Since a 
process can lock records beyond the logical end of file, 
the 'semaphore' file need not contain any data. 

Related Privileges: 

None. 
Parameters : 

lun - The logical unit number of the open file containing 
the records to be locked. 

recnum - The record number of the first record to be locked. 
Record number corresponds to the first record in 
the file. A record number of $FFFFFFFF (-1) corresponds 

to the current record. Records can be locked beyond the 

logical end of file, 
nrecs - The number of records to be locked. This value is 

an unsigned integer. A value of zero means to lock 

from the current position to the logical end of file, 
timout - The wait count is in 100' ths of a second and represents 
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the maximum amount of time to wait for the specified 

region to become available for locking, 

status - The address of a long word to receive the result of 
the operation. 



Diagnostics: 

er mom ema vail 
errtimeout 

errinvlfn 

errinvcloper 

errdeadlock 

errreclocked 

errlockint 

See Also: 



(7) All available memory has been allocated. 
(128) A request was not completed within the 

specified time. 
(132) The logical unit number does not correspond 

to an open file. 
(173) The device class is inappropriate for the 

operation. 

(234) The specified record cannot be locked without 
causing a deadlock. 

(235) The specified record(s) are locked by another 
process. 

(254) (MCS error) A discrepency in the Record Locking 
code has been detected. 



read - Read from an open file 

unlock - Unlock records in an open file 

write - Write to an open file 



Assembler 


Calling Sequence: 


push 


lun 


push 


recnum 


push 


nrecs 


push 


timout 


push 


status 


jsr 


lock 



C function declaration: 



long 
lock( lun, recnum, nrecs , timout) 
long lun; 
long recnum; 
long nrecs; 
long timout; 

Fortran Subroutine Declaration: 



jvalue - logical unit number 
;value - starting record number 
jvalue - number of records 
jvalue - time out 

;address - result of the operation 
;lock records within an open file 



/* lock records within an open file */ 
/* returns result of the operation */ 

/* logical unit number */ 
/* starting record number */ 
/* number of records */ 
/* time out */ 



! lock- records within an open file 
subroutine lock(lun, recnum, nrecs, .....out, status) 
integer*4 lun ! logical unit number 
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lock 



integer*4 recnum 
integer*4 nrecs 
integer*4 timout 
integer*4 status 

Pascal Procedure Declaration: 



procedure _lock( 
lun 

recnum 
nrecs 
t imout 
var status 

); external; 



longint ; 
longint ; 
longint; 
longint; 
longint 



! starting record number 

! number of records 

! time out 

! result of the operation 



{** lock records within an open file} 

{** logical unit number} 

{** starting record number} 

{** number of records} 

{** time out} 

{** result of the operation} 
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mapfp 



mapfp - Map floating point hardware 

Description: 

Map the physical address space of the specified type of 
hardware floating point into the calling process's logical 
address space. 

Related Privileges: 

None. 



Parameters : 
fptype 



adr 
size 

status 

Diagnostics : 
errinvadr 
errmemalloc 
errmemdeall 
errhavemath 



A constant representing the type of hardware 
to be mapped into the process's logical space. 
Valid values are: 



Name 

fpunmap 
fpskyl 
fpndp2 
fpffpl 



Value Description 



unmao the given logical address 

1 skyl" 

2 ndp2 

3 ffpl 



These are defined in, the file 

sys$disk/sysincl . sys/sysequ . asm 

The logical address into which the hardware 

will be mapped. Adr must be aligned on a 4 Kbyte 

boundary. 

The number of bytes to be mapped. That is, the 

size of the physical segment of memory to be mapped, 

This value will be rounded up to the hardware 

page size since only full pages can be mapped. 

Address of a long word to receive the result of 

the operation. 



(4) The logical/physical address, for the memory 
requested, is invalid. 

(5) The process requested a logical page that was 
already allocated. 

(9) The process attempted to affect memory that 
does not exist. 
(24) The process has already allocated floating 
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point hardware, 
errnoclass (185) The device class handler was not loaded when 

the system was booted, 
errnohardware (312) The PC board for the specified device is not 

installed. 

See Also: 



_mapphys 
__ fremem 



- Map physical address into logical address 

- Free memory 



Assembler Calling Sequence: 

push fptype 

push adr 

push size 

push status 

jsr _mapfp 

C function declaration: 



long 

_mapfp ( fptype, adr, size) 

long fptype; 

long adr; 

long size; 

Fortran Subroutine Declaration: 



value - type of hardware 

value - logical address 

value - length in bytes 

address - result of the operation 

map floating point hardware 



/* map floating point hardware */ 

/* returns result of the operation */ 

/* tyP 8 °f nat ^ hardware.*/ 

/* logical address to map into */ 

/* length of bytes to map */ 



! map floating point hardware 
subroutine mapfp (fptype, adr, size, status) 

! type of math hardware 



integer* 4 fptype 
integer *4 adr 
integer*4 size 
integer* 4 status 

Pascal Procedure Declaration: 



procedure mapfp ( 
fptype 
adr 
size 
var status 

) ; external ; 



longint; 
longint; 
longint; 
longint 



logical address to map into 
! length of bytes to map 
! result of the operation 



{** map floating point hardware } 

{** type of math hardware } 

{** logical address to map into } 

{** length of bytes to map } 
{** result of the operation} 
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mapphys 



mapphys - Map physical address into process's logical space 

Description: 

Map the given physical address into the process's logical space 
at the given address. 



Related Privileges: 
none 
chngsuper 

Parameters: 
physad 

adr 

size 

prot 

status 

Diagnostics : 

errinsufpriv 

errinvadr 

errmemalloc 

See Also: 

-jnapfp 
_fremem 



- The calling process cannot map physical memory into 
its logical space with this system call. 

- Allows a process to map physical memory into 
its logical address space. 



Physical address which is to be mapped into the 

process's address space. This address must be 

on a 4 Kbyte address boundary. 

The logical address into which the physical address 

will be mapped. Adr must be aligned on a 4 Kbyte 

boundary. 

The number of bytes to be mapped. That is, the 

size of the physical segment of memory to be mapped, 

This value will be rounded up to the hardware 

page size since only full pages can be mapped. 

Protection. indicates that the page(s) are not 

to be protected. 1 indicates that the page should 

be write protected. 

Address of a long word to receive the result of 

the operation. 



(1) The process lacks the privileges required to 
perform the operation. 

(4) The logical/physical address, for the memory 
requested, is invalid. 

(5) The process requested a logical page that was 
already allocated. 



Map floating point hardware into logical space 
Free memory 
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Assembler Calling Sequence: 



push 


physad 


push 


adr 


push 


size 


push 


prot 


push 


status 


jsr 


_mapphys 



C function declaration: 



;value - physical memory address 

;value - logical address 

; value - length in bytes 

;value - protection code 

;address - result of the operation 

;map physical address 



/* 

long /* 

-mappnys (physad , adr, size, prot) 

long physad; /* 

long adr; /* 

long size; /* 

long prot; /* 

Fortran Subroutine Declaration: 



map physical address */ 

returns result of the operation */ 

physical memory address */ 
logical address */ 
length in bytes */ 
protection code */ 



1 map physical address 
subroutine mapphy (physad, adr, size, prot* status) 



integer* 4 physad 
integer* 4 adr 
integer*4 size 
integer*4 prot 
integer* 4 status 



physical memory address 
logical address 
length in bytes 
protection code 
result of the operation 



Pascal Procedure Declaration: 



procedure mapphys ( 



physad 


: longint; 


• adr 


: longint; 


size 


: longint; 


prot 


: longint; 


var status 


: longint 


) ; external ; 





{** map physical address 

{** physical memory address 

{** logical address 

{** length in bytes 

{** protection code 

{** result of the operation 
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_MEMMNT 

Mount a logical device from memory. 

Description: 

This system call is similar to the _mount system call except that in 
this call, the device driver used to mount the device is obtained 
from a buffer in the process's memory (as opposed to a disk f ile) . 
This system call should be used when the process does not have access 
to any device which contains the device driver. 

This system call is used to announce the existence of a device to the 
system. The system mounts the device by loading a driver and 
initializing the device. If a device is already mounted with the 
specified driver, a new driver is not loaded, rather the current 
driver is shared. 

For disk and tape class devices which are not mounted "special", the 
owner of the volume and the protection specification for each class 
of user is specified in the volume label. 

For TTY, pipe and sync class devices, the owner of the device becomes 
the UIC of the process issuing the call to _memmnt. The protection 
mask for the device will be the default protection mask associated 
with the calling process. 

For devices mounted "special", the owner of the device becomes the 
UIC of the process issuing the call to _memmnt. The protection mask 
for the device will be the default protection mask associated with 
the calling process. 

The process issuing this system call must have operator privilege. 

In addition, the process must have delete access to the device being 
mounted according to the owner and group ID (UIC) of the volume and 
its protection mask. Note that any process with operator privilege 
can mount a TTY, pipe or sync class device with this system call. 
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Related Privileges: 

none » - The calling process cannot mount a device with 

this system call, 
altuic - If the calling process also has operator privilege, 

this privilege allows mounting of devices to which 

the owner of image file for this process has access 

as described above, 
bypass - If the calling process also has operator privilege, 

this privilege allows mounting of device independent 

of the device protection, 
operator - Allows mounting of devices to which the calling 

process has access as described above, 
system - If the calling process also has operator privilege, 

this privilege allows mounting of device if the system 

has access to the device as described above. 

Parameters: 

dname - Address of a null terminated string containing 

the name by which the device will be known. This 
string is translated automatically fcy the MCS to 
its logical equivalent. This string may contain 
up to 93 valid characters followed by a null, 
driver - Address of a buffer in the user process memory 

that contains the device driver to be used to mount 
the device. If a driver with the same identifier 
is found in the system, the driver is not loaded, 
class - The device class. Valid classes are: 

0,1 - Character class device (TTySpecial, TT£) 
2,3 - Tape class device (TapeSpecial , Tape) 
4,5 - Disk class device (DiskSpecial, Disk) 
6,7 - Network class device (NetworkSpecial, Network) 
8,9 - Pipe class device (PipeSpecial, Pipe) 
10,11- S^nc class device (SyncSpecial, Sync) 
12,13- Queue class device (QueueSpecial, Queue) 
14,15- Nondev class device (NonDevSpecial, NonDev) 
dstat - The address of a 128 byte buffer containing the 
initial device status to be assigned the device 
when it is mounted. If this parameter is zero 
the default device status is used. 

This parameter has two purposes: 

1) Tb provide an opportunity to set device characteristics 
that, unless set properly, would not allow the device 
to be mounted, e.g. , the tape block size) 
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_memmnt 

2) TO set device characteristics that could otherwise 
not be changed once the device is mounted. 

This parameter is not meant to be a substitute for 
_setdst. As such, not all of the values that can 
be specified with .jsetdst can be specified in this 
parameter . 

The device status table is divided into two parts. 
The first half is device independent and is composed 
of the following fields: 

Length 

(bytes) Settable Description 



dsclassid 

dsdriverid 
dsblksz 



No 

No 
Yes 



dsharderr 


2 


No 


dssofterr 


2 


No 


dsreadoper 


4 


No 


dswriteoper 


4 


No 


dsmaxnumdev 


2 


No 



dscurnumdev 



dsnumtoretry 



No 



Yes 



dserror reason 


4 


No 


dsreserved 


30 


No 


dsnexttableptr 


4 


No 



The device class. Uses the class 

parameter to the _mount system call. 

Unique ID number for this device driver 

block size of the device, e.g., sector 

size. For disks, the sector size is 

either 512 bytes or 1024 bytes, 

determined by the driver. Note that disk 

sector size cannot be changed. For tapes, 

the default is 1024 bytes. Specify zero 

to accept the default. 

The hard error count for the device 

The soft error count for the device 

Number of read operations on this device 

Number of write operations on this device 

Maximum # of devices this driver can 

handle 

Number of devices currently mounted using 

this device driver 

Number of times to retry before reporting 

a hard error. The default is determined 

by the driver. Specify zero (0) to accept 

the default. 

Hardware error code for the last error 

Reserved 

Address of next device status table 



The second half of the device status table is device 
class dependent. For TAPE class devices the second half 
is defined as follows: 
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Name 



Length 

(bytes) Settable Description 



dstpstatus 
dstpflagsl 



No 
Yes 



dstpspeed 



Yes 



dstpdensity 



Yes 



dstpiopbcnt 


2 


Yes 


dstpcachesz 


2 


Yes 


dstpreserved 
dstpuserfield 


46 
8 


No 
Yes 



Tape device status 

Tape status information. Bit encoded. If 
zero is specified , the default is used. 
Bit name bit # Description 



dstpdoraw 







dstpreadahead 



dstperrintenb 



0=Read after 
write disabled 
l=Read after 
write enabled 
0=Read ahead 
enabled 
l=Read ahead 
disabled 

0=Error interrupts 
are enabled 
l=Error interrupts 
are disabled 

Tape speed - Specify zero to use default 
- Reserved 

dstpspeedl2ips 1-12 ips 

dstpspeed25ips 2-25 ips 

dstpspeed30ips 3-30 ips 

dstpspeed50ips 4-50 ips 

dstpspeed90ips 5-90 ips 

dstpspeedlOOips 6 - 100 ips 

dstpspeedl25ips 7 - 125 ips 

Tape density - Specify to use default 

- Reserved 

1 - 800 bpi 

2 - 1600 bpi 

3 - 3200 bpi 

4 - 6250 bpi 

5 - 6400 bpi 

Number of IOIB's allocated to the drive. 

The default is determined by the driver. 

Specify zero to use the default 

# of sectors in disk cache. Default is 

determined by the value in the boot 

block. Specify to use the default. 

Reserved 

User defined status. The default is 

determined by the driver. Specify zero 

to use the default. 



dstpdens800bpi 
dstpdensl600bpi 
dstpdens3200bpi 
dstpdens6250bpi 
dstpdens640 Obpi 
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Name 



For DISK class devices the second half of the device 
status table is defined as follows: 

Length 

(bytes) Settable Description 



dsdkintfac 


2 


No 


dsdkiopbcnt 


2 


Yes 


dsdknumbsect 


4 


No 


dsdksectrack 


2 


No 


dsdkheads 


2 


No 


dsdkcylinders 


2 


No 


dsdkflagsl 


2 


No 


dsdkcurcyl 


2 


No 


dsdkcachesz 


2 


Yes 


dsdkentryname 


16 


No 


dsdkreserved 


20 


No 


dsdkuserfield 


8 


Yes 



Name 



Disk interleave factor 

Number of IOEB's allocated to the drive 

The default is determined by the driver 

Specify zero to use the default 

The number of sectors on the volume 

The number of sectors on a track 

The number of heads on the device 

The number of cylinders on the volume 

Disk status information. Bit encoded word 

Current cylinder position 

# of sectors in disk cache. Default is 

determined by the value in the boot 

block. Specify to use the default. 

The name of the drive type 

Reserved 

User defined status. The default is 

determined by the driver. Specify zero 

to use the default. 



For TH class devices the second half of the device 
status table is defined as follows: 

Length 

(bytes) Settable Description 



Uart mode register 1 

Uart mode register 2 

Uart command register 

Terminal type definition 

Uart status register 

Packet termination conditions 

Terminal status information 

Characters in input interrupt buffer 

Characters in output interrupt buffer 

Current column position 

Input buffer size in bytes. The default 

is determined by the driver. Specify 

zero to use the default. 

Output buffer size in bytes. The default 

is determined by the driver. Specify 

zero to use the default. 



dstymoderegl 


1 


No 


dstymodereg2 


1 


No 


dstycmdreg 


1 


No 


dstytermtype 


1 


No 


dstystatreg 


1 


No 


dstypacketterm 


1 


No 


dstyflagsl 


2 


No 


dstyinputcnt 


2 


No 


dstyoutptcnt 


2 


No 


dstycolumnpos 


2 


No 


dstyinbufsz 


2 


Yes 


dstyoutbufsz 


2 


Yes 



MEMMNT-5 



Dictionary of WMCS System Calls 
_jnemmnt 



dstywidth 


2 


No 


dstylength 


2 


No 


dstysubreadoper 


4 


No 


dstysufcwriteoper 


4 


No 


dstyreserved 


26 


No 


dstyuserfield 


8 


Yes 



Holds terminal width 

Holds terminal length 

Holds sub-read operations count 

Holds sub-write operations count 

Reserved 

User defined status. The default is 

determined by the driver. To use the 

default, specify zero. 



For PIPE class devices the second half of the device 
status table is defined as follows: 



Name 



Length 

(bytes) Settable Description 



dsppreaderpid 


4 


No 


dsppwriterpid 


4 


No 


dspppipeid 


4 


No 


dsppbuffersz 


2 


No 


dsppbuffercnt 


2 


No 


dsppreadque 


4 


No 


dsppwriteque 


4 


No 


dsppreserved 


32 


No 


dsppuserfield 


8 


Yes 



Name 



Process ID of pending reader 

Process ID of pending writer 

The pipe's ID 

The buffer size in bytes 

Number of characters in the pipe buffer 

Address of read queue 

Address of write queue 

Reserved 

User defined status. The default is 

determined by the driver. Specify zero 

to use the default. 



For SYNC class devices the second half of the device 
status table is defined as follows: 

Length 

(bytes) Settable Description 



Mode register 1 of the uart 

Mode register 2 of the uart 

Command register of the uart 

Terminal type definition 

Status register of uart 

Number of sync characters to write 

Device Status flags. Bit encoded. 

Number of characters in input interrupt 

buffer 

Number of characters in output interrupt 

buffer 

Input buffer size in bytes. The default 

is determined by the driver. Specify zero 

to use the default. 



dssymoderegl 


1 


No 


dssymodereg2 


1 


No 


dssycmdreg 


1 


No 


dssytermtype 


1 


No 


dssystatreg 


1 


No 


dssynumbsync 


1 


No 


dssyflagsl 


2 


No 


dssyinputcnt 


2 


No 


dssyoutputcnt 


2 


No 


dssyinbufsz 


2 


Yes 
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dssyoutbufsz 



Yes 



dssyprevrderr 


4 


No 


dssyprevwrerr 


4 


No 


dssyprevrdtype 


1 


No 


dssynumbtrpad 


1 


No 


dssyrecsize 


2 


No 


dssyreserved 


28 


No 


dssyuserfield 


8 


Yes 



Output buffer size in bytes. The default 

is determined by the driver. Specify zero 

to use the default. 

Error from previous un-verified read 

Error from previous no-wait write 

Type of previous read 

Number of trailing pads to write 

Used in transparent mode with ITBs 

Reserved 

User defined status. The default is 

determined by the driver. Specify zero 

to use the default. 



For NETWORK class devices the second half of the device 
status table is defined as follows: 



Name 



Length 

(bytes) Settable Description 



dsnkflags 


2 


No 


Device status flags. Bit encoded. 
Bit Name Bit # Description 
dsnkbyte 0=datagram mode 

l=byte mode 
dsnkmodemctrl 1 0=not enabled 

l=modem Ctrl enabled 


dsnkwindowsiz e 


1 


No 


Window size the circuit will use 


dsnkreserved 


53 


No 


Reserved 


dsnkuserfield 


8 


No 


User defined status 



Name 



For NCNDEV class devices the second half of the device 
status table is defined as follows: 

Length 

(bytes) Settable Description 



dsnduserfield 



64 



No 



User defined status 



Name 



For QUEUE class devices the second half of the device 
status table is defined as follows: 

Length 

(bytes) Settable Description 



dsquassocdev 
dsqusenddev 



No A null terminated string containing the 
name of the physical printer device 

No A null terminated string containing the 
name of the physical device that control 
messages are to be sent to 



MEMMOTV7 



Dictionary of WMCS System Calls 
_memmnt 



dsquformname 10 No 

dsqunumexec 2 No 

dsqucurnumexec 2 No 

dsquflags 2 Yes 



dsqulength 


2 


No 


dsquwidth 


2 


No 


dsqunextentry 
dsqutype 


4 

1 


No 
Yes 



dsqubaseprior 

dsqureserved 
dsquuserfield 



20 
8 



No 

No 
No 



A null terminated string containing the 

current form name 

This is the maximum number of entries 

that can execute concurrently 

This is the number of entries that are 

currently active 

Device Status flags. Bit encoded. 

Bit Name Bit # Description 



dsquflupdating 



dsquflqmstay 



dsquflnorestart 



Updating current 
queue control 
file 

Queue manager 
process will 
remain running 
even when the 
queue is empty 
When the queue 
is mounted it 
does not restart 
jobs in queue 
Holds the length of the forms of the 
printer associated with this queue 
Holds the width of the forms of the 
printer associated with this queue 
Entry number of the next entry queued 
Ihe type of queue this is. Values are: 
Value Name Value Description 



dsqutpprint 1 Print type queue 

dsqutpjob 2 Job entry queue 

Priority that entries will be queued at 

if they specify the default priority 

Reserved 

User defined status 



label 



status 



- Address of a 17 byte string to receive the device 
label. The returned string will be null terminated 
(up to 16 valid characters and a null) . 

- Address of a long word to receive the result of 
the operation. 



Diagnostics : 

errinsufpriv 
er rnomemavail 



(1) The process lacks the privileges required to 

perform the operation. 
(7) All available memory has been allocated. 
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errinvdevnam ( 


130) 


errnoexecpriv < 


143) 


errnoreadpriv ( 


144) 


errimprdmnt ( 
errinvcloper ( 


164) 
173) 


errdevnamexs < 
errinvclass ( 


179) 
180) 


efrnobbfound I 
errinvdmreq ( 


:i81) 
183) 


errnoclass ( 


,185) 


errprevinit ( 


:i88) 


errmntasync 


[190) 


errmntsync 


:i9i) 


errinvdriver 


[216) 


errdevwrtprot 
errcantreaddsr 


(269) 
(308) 


errinvdrvnum 


(311) 


errnohardware 


(312) 


See Also: 





The specified devicename is syntactically 

incorrect. 

The process does not have Execute Privilege 

for the file. 

The process does not have Read Privilege for 

the file. 

This device was improperly dismounted. 

The operation is inappropriate for the 

device class. 

The specified device is already mounted. 

The MCS does not recognize the specified 

device class. 

The specified volume has no valid boot block. 

The process requested more than 3964 bytes 

of dynamic memory. 

The device class handler was not loaded when 

the system was booted. 

The specified device is already mounted , and 

has another name. 

The specified device has already been mounted 

for synchronous use. 

The specified device has already been mounted 

for asynchronous use. 

The specified file does not contain a device 

driver. 

The specified device is w rite-protected. 

The size of the device driver does not match 

its expected size. 

A value in at least one field of the devicename 

is disallowed. 

The PC board for the specified device is not 

installed. 



_dismnt - Dismount a logical device 

_jilush - Flush I/O buffers to the device 

_getdnam - Get devicename 

_getdst - Get device status 

_giodst - Get device status with LUN 

_setdst - Set device status 

_sicdst - Set device status with LUN 
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Assembler Calling Sequence: 

%% sy s$disk/sy sincl . sys/dstatdisp. asm 

push dname ; address - devicename 

push driver ;address - buffer containing driver 

push class ;value - device class 

push dstat ; address - initial device status 

push label /address - device label 

push status ; address - result of the operation 

jsr _meramnt ;mount a logical device from memory 

C Function Declaration: 

#include "sys $disk/sy sincl . sys/dstatdisp. h n 

/* mount a logical device from memory */ 

long /* returns result of the operation */ 

_memmnt (dname , driver, class, dstat, label) 

char dname [94] ; /* devicename */ 
char *driver; /* buffer containing driver */ 
long class; /* device class */ 

devicestatus dstat /* initial device status */ 
char label [17]; /* device label */ 

FORTRAN Subroutine Declaration: 

c I mount a logical device from memory 

subroutine _memmnt (dname, driver, class, dstat, label, 

status) 
character *94 dname 1 devicename 
character* (*) driver I buffer containing driver 
integer *4 class ! device class 
character* (*) dstat ! initial device status 
character *17 label ! device label 
integer*4 status I result of the operation 

Pascal Procedure Declaration: 

Note - If passing a device status block, use the following 
expression : cast (vice (devicestatus) , longint) 

%%sys$disk/sysincl . sys/dstatdisp. pas 

procedure _jnemmnt( {** mount a logical device from memory} 



dname 
driver 
class 
dstat 
var vlabel 
var status 
) ; external ; 



string [93]; {** devicename) 

~array_ofL_char; {** buffer containing driver} 

longint; (** device class) 

longint; {** initial device status) 

string [16]; {** device label) 

longint {** result of the operation) 
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Mount a logical device. 

Description: 

This system call is used to announce the existence of a device to the 
system. The system then mounts the device by loading a driver and 
initializing the device. If the device driver is already present in 
memory , a new one is not loaded , rather the current driver is shared. 

For disk and tape class devices which are not mounted "special", the 
owner of the volume and the protection specification for each class 
of user is specified in the volume label. 

For TH, pipe and sync class devices, the owner of the device becomes 
the UIC of the process issuing the call to _mount. The protection 
mask for the device will be the default protection mask associated 
with the calling process. 

For devices mounted "special", the owner of the device becomes the 
UIC of the process issuing the call to _mount. The protection mask 
for the device will be the default protection mask associated with 
the calling process. 

The process must have read privilege to the device containing the 
device driver, execute privilege to all directories in the path to 
the device driver, read privilege to the directory containing the 
device driver and read privilege to the file containing the device 
driver. 

If the process has operator privilege, it can mount a device using a 
device driver that is not installed. If the process does not have 
operator privilege, it can only mount devices using installed device 
drivers. In either case, the process must satisfy the following 
requirements. 

If the driver is specified by fcb.seq number, the process must have 
read privilege to the device containing the driver and read privilege 
to the file containing the driver. 
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In addition f the process must have execute access to the device being 
mounted according to the owner and group TQ (UIC) of the volume and 
its protection mask. Note that any process can mount a TOY, pipe or 
sync class device. 

The process must have operator privilege in order to mount any device 
as "special " (diskspc, ttyspc, etc.). 

Related Privileges: 



none 

altuic 

bypass 
operator 
system — 

Parameters: 
dname 



driver 



- Allows mounting of device if the process has 
privileges as described above and the driver 
has been installed. 

- Allows mounting of device if the owner of the 
image file of the current process has access to 
the file and device as described above. 

- Allows mounting of device independent of the 
file protection. 

- Allows mounting of devices as ' special ' . Also 
allows mounting devices with uninstalled drivers. 
Allows mounting of device if the system has 
access to the file and device as described above. 



Address of a null terminated string containing 
the name by which the device will be known. This 
string will be translated automatically by the MCS 
to its logical equivalent. This string may contain 
up to 93 valid characters followed by a null. 
Address of a null terminated string containing 
the name of the file which contains the device 
driver. If a driver with the same identifier 
(irrespective of file name) is found in the system, 
the driver is not loaded. This string will be translated 
automatically by the MCS to its logical equivalent. This 
string may contain up to 93 valid characters followed 
by a null. 
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class 



dstat 



Name 



- The device class. Valid classes are: 

0,1 - Character class device (TTTSpecial, TTY) 
2,3 - Tape class device (TapeSpecial , Tape) 
4,5 - Disk class device (DiskSpecial, Disk) 
6,7 - Network class device (NetworkSpecial, Network) 
8,9 - Pipe class device (PipeSpecial, Pipe) 
10,11- Sync class device (SyncSpecial, Sync) 
12,13- Queue class device (QueueSpecial, Queue) 
14,15- Nondev class device (NondevSpecial, Nondev) 

- The address of a 128 byte buffer containing the 
initial device status to be assigned the device 
when it is mounted. If this parameter is zero 
the default device status is used. 

This parameter has two purposes: 

1) To provide an opportunity to set device characteristics 
that, unless set properly, would not allow the device 
to be mounted, e.g., the tape block size. 

2) To set device characteristics that could otherwise 
not be changed once the device is mounted, e.g., disk 
cache size. 

This parameter is not meant to be a substitute for 
_setdst. As such, not all of the values that can 
be specified with _setdst can be specified in this 
parameter. 

The device status table is divided into two parts. 
The first half is device independent and is composed 
of the following fields: 

Length 

(bytes) Settable Description 



dsclassid 

dsdriverid 
dsblksz 



No 

No 
Yes 



dsharderr 


2 


No 


dssofterr 


2 


No 


dsreadoper 


4 


No 



The device class. Uses the class 
parameter to the _mount system call. 
Unique 3D number for this device driver 
block size of the device, e.g., sector 
size. For disks, the sector size is 
either 512 bytes or 1024 bytes, 
determined by the driver. Note that disk 
sector size cannot be changed. For tapes, 
the default is 1024 bytes. Specify zero 
to accept the default. 
The hard error count for the device 
The soft error count for the device 
Number of read operations on this device 
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dswriteoper 4 
dsmaxnumdev 2 


No 
No 


dscurnumdev 2 


No 


dsnumtoretry 2 


Yes 


dserror reason 4 
dsreserved 30 
dsnexttableptr 4 


No 
No 
No 



Number of write operations on this device 

Maximum # of devices this driver can 

handle 

Number of devices currently mounted using 

this device driver 

Number of times to retry before reporting 

a hard error. The default is determined 

by the driver. Specify zero (0) to accept 

the default. 

Hardware error code for the last error 

Reserved 

Address of next device status table 



The second half of the device status table is device 
class dependent. For TAPE class devices the second part 
is defined as follows: 



Name 



Length 

(bytes) Settable Description 



dstpstatus 


2 


No 


Tape device status 




dstpflagsl 


2 


Yes 


Tape status information 


i. Bit encoded. If 








zero is specified , the default is used. 








Bit name bit # 


Description 




dstpdoraw 


0=Read after 










write disabled 










l=Read after 










write enabled 








dstpreadahead 1 


0=Read ahead 
enabled 
l=Read ahead 
disabled 








dstperrintenb 2 


0=Error interrupts 
are enabled 
l=Error interrupts 
are disabled 


dstpspeed 


1 


Yes 


Tape speed - Specify zero to use default 
- Reserved 








dstpspeedl2ips 1-12 


ips 








dstpspeed25ips 2-25 


ips 








dstpspeecBOips 3-30 


ips 








dstpspeedSOips 4-50 


ips 








dstpspeed90ips 5-90 


ips 








dstpspeedlOOips 6 - 10C 


1 ips 








dstpspeedl25ips 7-125 


> ips 






MOUNP-4 





dstpdensity 



Yes 



dstpiopbcnt 



dstpcachesz 



dstpreserved 
dstpuserfield 



46 
8 



Yes 



Yes 



No 
Yes 
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dstpdens800bpi 

dstpdensl6 OObpi 

dstpdens3200bpi 

dstpdens6250bpi 

dstpdens640 Obpi 

Number of IOEB's allocated to the drive. 

The default is determined by the driver. 

Specify zero to use the default 

# of sectors in disk cache. Default is 

determined by the value in the boot 

block. Specify to use the default. 

Reserved 

User defined status. The default is 

determined fcy the driver. Specify zero 

to use the default. 



*l?e 


jcify 


to use 


default 





- Reserved 




1 


- 800 1 


Dpi 




2 


- 1600 


bpi 




3 


- 3200 


bpi 




4 


- 6250 


bpi 




5 


- 6400 


bpi 





Name 



For DISK class devices the second half of the device 
status table is defined as follows: 

Length 

(bytes) Settable Description 



dsdkintfac 
dsdkiopbcnt 



dsdknumbsect 

dsdksectrack 

dsdkheads 

dsdkcylinders 

dsdkflagsl 

dsdkcurcyl 

dsdkcachesz 



dsdkentryname 

dsdkreserved 

dsdkuserfield 



16 

20 

8 



No Disk interleave factor 
Yes Number of IOFB's allocated to the drive 
The default is determined by the driver 
Specify zero to use the default 
No The number of sectors on the volume 
No The number of sectors on a track 
No The number of heads on the device 
No The number of cylinders on the volume 
No Disk status information. Bit encoded word 
No Current cylinder position 
Yes # of sectors in disk cache. Default is 
determined by the value in the boot 
block. Specify to use the default. 
No The name of the drive type 
No Reserved 
Yes User defined status. The default is 

determined by the driver. Specify zero 
to use the default. 



For TTY class devices the second half of the device 
status table is defined as follows: 
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Name 



Length 

(bytes) Settable Description 



dstymoderegl 


1 


No 


dstymodereg2 


1 


No 


dstycmdreg 


1 


No 


dstytermtype 


1 


No 


dstystatreg 


1 


No 


dstypacketterm 


1 


No 


dstyflagsl 


2 


No 


dstyinputcnt 


2 


No 


dstyoutptcnt 


2 


No 


dsty col umnpos 


2 


No 


dstyinbufsz 


2 


Yes 


dstyoutbufsz 


2 


Yes 


dstywidth 


2 


No 


dsty length 


2 


No 


dstysubreadoper 


4 


No 


dstysubwriteoper 


4 


No 


dsty reserved 


26 


No 


dstyuserfield 


8 


Yes 



Uart mode register 1 

Uart mode register 2 

Uart command register 

Terminal type definition 

Uart status register 

Packet termination conditions 

Terminal status information 

Characters in input interrupt buffer 

Characters in output interrupt buffer 

Current column position 

Input buffer size in bytes. Ihe default 

is determined fcy the driver. Specify 

zero to use the default. 

Output buffer size in bytes. 

is determined by the driver. 

zero to use the default. 

Holds terminal width 

Holds terminal length 

Holds sub-read operations count 

Holds sub-write operations count 

Reserved 

User defined status. The default is 

determined by the driver. To use the 

default, specify zero. 



The default 
Specify 



Name 



For PIPE class devices the second half of the device 
status table is defined as follows: 

Length 

(bytes) Settable Description 



dsppreaderpid 


4 


No 


dsppwriterpid 


4 


No 


dspppipeid 


4 


No 


dsppbuffersz 


2 


No 


dsppbuffercnt 


2 


No 


dsppreadque 


4 


No 


dsppwriteque 


4 


No 


dsppreserved 


32 


No 


dsppuserfield 


8 


Yes 



Process ID of pending reader 

Process ID of pending writer 

The pipe's ID 

The buffer size in bytes 

Number of characters in the pipe buffer 

Address of read queue 

Address of write queue 

Reserved 

User defined status. The default is 

determined by the driver. Specify zero 

to use the default. 
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For SYNC class devices the second half of the device 
status table is defined as follows: 



Name 



Length 

(bytes) Settable Description 



dssymoderegl 


1 


No 


dssymodereg2 


1 


No 


dssycmdreg 


1 


No 


dssytermtype 


1 


No 


dssystatreg 


1 


No 


dssynumbsync 


1 


No 


dssyflagsl 


2 


No 


dssyinputcnt 


2 


No 


dssyoutputcnt 


2 


No 


dssyinbufsz 


2 


Yes 



dssyoutbufsz 



Yes 



dssyprevrderr 


4 


No 


dssyprevwrerr 


4 


No 


dssyprevrdtype 


1 


No 


dssynumbtrpad 


1 


No 


dssyrecsize 


2 


No 


dssyreserved 


28 


No 


dssyuserfield 


8 


Yes 



Name 



Mode register 1 of the uart 

Mode register 2 of the uart 

Command register of the uart 

Terminal type definition 

Status register of uart 

Number of sync characters to write 

Device Status flags. Bit encoded. 

Number of characters in input interrupt 

buffer 

Number of characters in output interrupt 

buffer 

Input buffer size in bytes. The default 

is determined by the driver. Specify zero 

to use the default. 

Output buffer size in bytes. The default 

is determined by the driver. Specify zero 

to use the default. 

Error from previous un-verified read 

Error from previous no-wait write 

Type of previous read 

Number of trailing pads to write 

Used in transparent mode with ITBs 

Reserved 

User defined status. The default is 

determined by the driver. Specify zero 

to use the default. 



For NETWORK class devices the second half of the device 
status table is defined as follows: 

Length 

(bytes) Settable Description 



dsnkflags 


2 


No 


Device status flags. Bit encoded. 
Bit Name Bit # Description 
dsnkbyte 0=datagram mode 

l=byte mode 
dsnkmodemctrl 1 0=not enabled 

l=modem ctrl enabled 


dsnkwindowsize 


1 


No 


Window size the circuit will use 


dsnkreserved 


53 


No 


Reserved 


dsnkuserf ield 


8 


No 


User defined status 
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Name 



For NCNDEV class devices the second half of the device 
status table is defined as follows: 

Length 

(bytes) Settable Description 



dsnduserfield 



64 



No 



User defined status 



Name 



For QUEUE class devices the second half of the device 
status table is defined as follows: 

Length 

(bytes) Settable Description 



dsquassocdev 


9 


dsqusenddev 


9 


dsquformname 


10 


dsqunumexec 


2 


dsqucurnumexec 


2 


dsquflags 


2 



dsqulength 2 
dsquwidth 2 
dsqunextentry 4 



No 



No 



No 



No 



No 



Yes 



No 
No 
No 



A null terminated string containing the 

name of the physical printer device 

A null terminated string containing the 

name of the physical device that control 

messages are to be sent to 

A null terminated string containing the 

current form name 

This is the maximum number of entries 

that can execute concurrently 

This is the number of entries that are 

currently active 

Device Status flags. Bit encoded. 

Bit Name Bit # Description 



dsqufl updating Updating current 

queue control 
file 
dsquflqmstay 1 Queue manager 

process will 
remain running 
even when the 
queue is empty 
I When the queue 

is mounted it 
does not restart 
jobs in queue 
Holds the length of the forms of the 
printer associated with this queue 
Holds the width of the forms of the 
printer associated with this queue 
Entry number of the next entry queued 



dsquflnorestart 
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dsqutype 



dsqubaseprior 

dsqureserved 
dsquuserfield 



Yes 



20 
8 



No 

No 
No 



The type of queue this is. Values are: 
Value Name Value Description 



dsqutpprint 1 Print type queue 

dsqutpjob 2 Job entry queue 

Priority that entries will be queued at 

if they specify the default priority 

Reserved 

User defined status 



label - Address of a 17 byte string to receive the device 

label. The returned string will be null terminated, 
(up to 16 valid characters and a null) 

status - Address of a long word to receive the result of 
the operation. 



The process lacks the privileges required to 

perform the operation. 

All available memory has been allocated. 

The specified devicename is syntactically 

incorrect. 

The MCS does not recognize the devicename. 

Is the device mounted? 

The specified file could not be found. 

The specified file is read-locked. 

The process tried to read past the logical end 

of a file. 

The process does not have Execute Privilege for 

the file. 

The process does not have Read Privilege for 

the file. 

The specified filename is syntactically incorrect. 

The specified directory is not a directory 

type file 

The specified directory name is syntactically 

incorrect. 

This device was improperly dismounted. 

The operation is inappropriate for the 

device class. 

The specified directory does not exist. 

The specified device is already mounted. 

The MCS does not recognize the specified 

device class. 

The specified volume has no valid boot block. 



Diagnostics : 




errinsufpriv 


(1) 


errnomemavail 
errinvdevnam 


(7) 
(130) 


errundevnam 


(131) 


errfilnotfnd 

errreadlock 

errreadleof 


(133) 
(135) 
(140) 


errnoexecpriv 


(143) 


errnoreadpriv 


(144) 


errinvfnstr 
errinvdirfle 


(147) 
(148) 


errinvdirstr 


(149) 


errimprdmnt 
errinvcloper 


(164) 
(173) 


errdirnotfnd 
errdevnamexs 
errinvclass 


(177) 
(179) 
(180) 


errnobbfound 


(181) 
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errinvdmreq (183) 

errnoclass (185) 

errprevinit (188) 

errmntasync (190) 

errmntsync (191) 

errinvdriver (216) 

errdevwrtprot (269) 

errcantreaddsr (308) 

errinvdrvnum (311) 

errnoharoware (312) 



The process requested more than 3964 bytes 

of dynamic memory. 

The device class handler was not loaded when 

the system was booted. 

The specified device is already mountedr and 

has another name. 

The specified device has already been mounted 

for synchronous use. 

The specified device has already been mounted 

for asynchronous use. 

The specified file does not contain a device 

driver. 

The specified device is write-protected. 

The size of the device driver does not match 

its expected size. 

A value in at least one field of the devicename 

is disallowed. 

The PC board for the specified device is not 

installed. 

Device integrity errors 



See Also: 



_dismnt - 
_£lush - 
_getdnam- 
_getdst - 
_giodst - 
_setdst - 
_siodst - 



Dismount a logical device 

Flush I/O buffers to the device 

Get devicename 

Get device status 

Get device status with lun 

Set device status 

Set device status with lun 



Assembler Calling Sequence: 

%%sys$disk/sysincl . sys/dstatdisp. asm 

push dname ; address - devicename 

push driver ;address - driver file name 

push class ;value - device class 

push dstat ;address - initial device status 

push label ;address - device label 

push status ;address - result of the operation 



Dsr 



_mount 



;mount a logical device 
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C Function Declaration: 

#incl ude "sy s $disk/sy sincl . sy s/dstatdisp. h" 

/* mount a logical device */ 
long /* returns result of the operation */ 

_mount (dname, driver, class, dstat, label) 



char dname[94] ; 
char driver [94] ; 
long class; 
devicestatus *dstat; 
char label [17] ; 

FORTRAN Subroutine Declaration: 



subroutine mount (dname, 
character *94 dname 
character*94 driver 
integer*4 class 
character* (*) dstat 
character *17 label 
integer *4 status 

Pascal Procedure Declaration: 



/* devicename */ 

/* driver file name */ 

/* device class */ 

/* initial device status */ 

/* device label */ 



I mount a logical device 
driver, class, dstat, label, status) 
I devicename 
1 driver file name 
I device class 
! initial device status 
! device label 
! result of the operation 



Note - If passing a device status block, use the following 
expression : cast ( vice (devicestatus) , longint) 



%%sys$disk/sysincl . sys/dstatdisp. pas 



procedure _mount 


1 


{** 


dname 


: string [93] ; 


{** 


driver : 


: string[93]; 


{** 


class 


: longint; 


{** 


dstat ; 


: longint; 


{** 


var vlabel 


: string [16]; 


{** 


var status 


: longint 


{** 


) ; external ; 







mount a logical device} 

devicename) 

driver file name) 

device class) 

initial device status) 

device label) 

result of the operation) 
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^MULCRPS 
Multiple create process. 

Description: 

This call is similar to _crproc except that it creates several 
instances of the process. It is to be used in the situation where 
you want to start up multiple instances of the same process on 
several different terminals. The image file from which the processes 
are created is the same for all the processes. 

Each process under control of the operating system must be created by 
a call to the operating system. When a process is created, it is 
called a child process. The process that created it is called its 
parent process. 

This system call only allows forking of child processes. Forked 
processes run in parallel with the parent process. 

The calling process must have read privilege to the device containing 
the image file, execute privilege to all directories in the path 
leading to the directory containing the image file, read privilege to 
the directory containing the image file and execute privilege to the 
file containing the child process image for successful creation of 
the child process. 

If the image file is specified by fcb.seq number then the process 
must have read privilege to the device containing the image file and 
execute privilege to the file containing the image. 

Without the setpriv privilege, the child processes may not be given 
more privileges than the parent has. 

Related Privileges: 

none - Allows the parent process to create a child 

from an image file to which the parent has 

access as described above, 
bypass - Allows the parent process to create a child 

process independent of the file protection, 
setpriv - Allows the parent process to give the child 

process more privileges than thos possessed 

by the parent. 
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setprior - Allows the parent process to initate a child 

at a higher priority level and/or with a higher 
time slice than the parent. 



Parameters: 
siteid 

fname 



repit 



pname 



priv 



The siteid of the system on which the processes 

are to be created. If the siteid is zero, the 

processes will be created on the same system as 

the calling process. 

Address of a 94 byte null terminated string 

specifying the name of the file containing the 

process image. (93 significant characters plus 

a null) . This string will be translated to its 

logical equivalent. 

The number of repetitions, i.e. the number of 

identical processes to intiate from the image 

file. 

Address of an array of pointers to 17 byte null 

terminated strings containing the process names 

to be given the new processes. These strings are 

used for human identification. There must be as many 

pointers as there are processes to be created. 

(as indicated by the parameter repit) They may contain 

up to 16 valid characters followed by a null. 

The privilege mask contains a bit mask of 

privileges to be given to the child processes. 

Each child process receives the same privileges. 

A -1 ($FFFFFFFF) indicates that the children should 

receive the same privileges that the parent has. 

Privileges are bit encoded as follows: 



Bit Name 


Bit 


Description 


pcbpvsetpriv 





setpriv 


pcbpvsystem 


1 


system 


pcbpvreadphys 


2 


readphys 


pcbpvwritephys 


> 3 


writephys 


pcbpvsetprior 


4 


setprior 


pcbpvchngsupei 


: 5 


chngsuper 


pcbpvbypass 


6 


bypass 


pcbpvoperator 


7 


operator 


pcbpvaltuic 


8 


altuic 


pcbpvworld 


9 


world 


pcbpvgroup 


10 


group 


pcbpvnetwork 


11 


network 


pcbpvsetattr 


12 


setattr 




13-31 


Reserved. 



Must be set to zero 
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priort - The priority level (0..3) at which the child 

processes will execute. Level is the highest 
priority. A minus one (-1 or $FFFFFFFF) in this 
parameter means to use the same priority as the 
parent process. 

tslice - The time slice value. The maximum amount of time 
each of the child processes will be allowed to run 
each time they are scheduled. This time is specified 
in .01 milliseconds. A time slice of 100 represents 
1 millisecond. A minus one (-1 or $FFFFFFFF) means 
to use the same time slice as the parent process. 

uic - The user identification code of the child processes. 
The most significant 16 bits represent the owner id 
and the least significant 16 bits represent the 
group id. Each child process will have the same uic. 

sysin - Address of an array of pointers to null terminated strings 
containing the names of the standard input files for 
each of the child processes. Each string will 
be translated by MCS to its logical equivalent. 
There must be as many pointers as there are processes 
to be created. The 1st pointer points to the string 
containing the name of the standard input file for 
the first process to be created. The 2nd pointer 
points to the string containing the name of the 
standard input file for the second process to be 
created, and so on. The strings will be assigned 
to the logical name "SYS$INRJT in the logical name 
table of the corresponding child process. The strings 
passed are not checked for validity. Each string may 
contain up to 93 significant characters followed by a 
null. 

sysout - Address of an array of pointers to null terminated strings 
containing the names of the standard output files for 
each of the child processes. Each string will 
be translated by MCS to its logical equivalent. 
There must be as many pointers as there are processes 
to be created. The 1st pointer points to the string 
containing the name of the standard output file for 
the first process to be created. The 2nd pointer 
points to the string containing the name of the 
standard output file for the second process to be 
created, and so on. The strings will be assigned 
to the logical name "SYS$OUTPUT in the logical name 
table of the corresponding child process. The strings 
passed are not checked for validity. Each string may 
contain up to 93 significant characters followed by a null 
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syserr - Address of an array of pointers to null terminated strings 
containing the names of the standard error files for 
each of the child processes. Each string will 
be translated by MCS to its logical equivalent. 
There must be as many pointers as there are processes 
to be created. The 1st pointer points to the string 
containing the name of the standard error file for 
the first process to be created. The 2nd pointer 
points to the string containing the name of the 
standard error file for the second process to be 
created, and so on. The strings will be assigned 
to the logical name "SYS$EFRQR in the logical name 
table of the corresponding child process. The strings 
passed are not checked for validity. Each string may 
contain up to 93 significant characters followed by a null. 

cmd - Address of an array of pointers to the command lines for 
each process. Each command line may contain up to 3072 
bytes. The command lines may contain any data whatever 
to be passed from the parent to the children. There must be 
as many pointers to command lines as there are child 
processes to create. The first pointer points to the 
command line for the first process to be created. The 
2nd pointer points to the command line for the second 
process to be created, and so on. 

The command lines will appear on the top of the child 
process's stack as each child process begins. The long 
word at the top of the child's stack is the length in 
bytes of the command line. At the location (USIN-4) 
on the child's stack is a long word which contains 
the starting address of the command line. 

cmdlen - Address of an array of long words containing the length 
of each of the command lines. The length is specified 
in bytes. 

pid - Address of an array of long words to receive the pids 
of the child processes. This array is assumed to be 
long enough to contain the pids of as many processes 
as were requested to be created, (see repit) 

prccnt - Address of a long word to receive the number of processes 
that were successfully created. If this number is less 
than the number of desired processes (see repit) , then 
the status variable indicates the error that prevented 
the "next" process from being created. 

status - Address of a long word to receive the result of 
the operation. 



MuTiCRPS-4 



Dictionary of WMCS System Calls 

_mulcrps 



Diagnostics : 



errinsufpriv (1) 

errnomemavail (7) 

errinvsiteid (8) 

errnotimfle (21) 

er r imagebmbad ( 53 ) 

errinvdevnam (130) 

errundevnam (131) 

errfilnotfnd (133) 

errreadleof (140) 

er rnoexecpr iv ( 143 ) 

errnoreadpriv (144) 

errinvfnstr (147) 

errinvdirfle (148) 

errinvdirstr (149) 

er r di rnotf nd ( 177 ) 

errfilopen (202) 



See Also: 



The process lacks the privileges required to 

perform the operation. 

All available memory has been allocated. 

The specified site id does not exist. 

The specified file is not an image file. 

(MCS error) The bitmap changed during the 

creation of the process. 

The specified devicename is syntactically 

incorrect. 

The MCS does not recognize the devicename. 

Is the device mounted? 

The specified file could not be found. 

The process tried to read past the logical end 

of a file. 

The process does not have Execute Privilege 

for the file. 

Tftie process does not have Read Privilege for 

the file. 

The specified filename is syntactically incorrect. 

The specified directory is not a directory. 

The specified directory name is syntactically 

incorrect. 

The specified directory does not exist. 

The process tried to simultaneously open more 

than one tape file. 



_clone 

_crprcs 

__crproc 

_exproc 

_jsetpnam 

_setpri 

_settmsl 

_setuic 



Clone an existing process 
Simplified create process 
Create a new process 
Terminate the specified process 
Change process name 
Change priority level 
Change scheduling time slice 
Set process uic 
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Assembler Calling Sequence: 



push 


siteid 


push 


fname 


push 


repit 


push 


pname 


push 


priv 


push 


priort 


push 


tslice 


push 


uic 


push 


sysin 


push 


sysout 


push 


syserr 


push 


cmd 


push 


cmdlen 


push 


pid 


push 


prccnt 


push 


status 


jsr 


_mulcrps 


iction 


Declaration: 


long 




_mulcrps (siteid, fname, 




sysin, sysout 




long siteid; 




char fname [94] ; 




long repit; 




char *pname[] ; 




long priv; 




long priort; 




long tslice; 




long uic; 




char *sysin[] ; 




char *sysout[] ; 




char *syserrU ; 




char *cmd[] ; 




long cmdlen [] ; 




long pidll ; 




long *prccnt; 



;value - system id 
; address - name of image file 
;value - number of instances 
; address - process names 
;value - process privilege 
;value - process priority 
; value - process time slice 
; value - user identification code 
standard input files 
standard output files 
standard error files 
command lines 
length of command lines 



; address 
; address 
; address 
; address 
; address 
; address 
; address 
; address 



- child's pid 

- process count 
result of the operation 



;multiple create process 



/* multiple create process */ 

/* returns result of the operation */ 
repit, pname, priv, priort, tslice, uic, 
, syserr, cmd, cmdlen, pid, prccnt) 

/* system id */ 

/* name of image file */ 

/* number of instances */ 

/* process name */ 

/* process privilege */ 

/* process priority */ 

/* process time slice */ 

/* user identification code */ 

/* standard input files */ 

/* standard output files */ 

/* standard error files */ 

/* command lines */ 

/* length of command lines */ 

/* child's pid */ 

/* process count */ 



FORERAN Function Declaration: 



NOTE: This system call is not directly accessible from FOREMAN. 
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procedure _mulcrps( 



siteid s 


longint; 


fname : 


■ string [931; 


repit : 


longint; 


pname : 


~array_ofL_char 


priv : 


longint; 


priort : 


• longint; 


tslice j 


• longint; 


uic : 


longint; 


sysin : 


: *array_of_char 


sysout ! 


: ~array_of_char 


syserr ; 


: ~array_of_char 


cmd : 


~array_of_char 


cmdlen 


: array[l..l] of 


var pid : 


arraytl.,1] of 


var prccnt « 


: longint; 


var status 


: longint 


external ; 





{** multiple create process) 

{** system id} 

{** name of image file) 

{** number of instances) 

;{** process name) 

{** process privilege) 

{** process priority) 

{** process time slice) 

{** user identification code) 

;{** standard input files) 

;{** standard output files) 

;{** standard error files) 

;{** command line) 

longint; {** length of command lines) 

longint; {** child's pid) 
{** process count) 
{** result of the operation) 
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Open a file. 



Description: 

After logical name translation, the specified file is made available 
to the calling process for the type(s) of I/O requested. Upon 
successful completion it returns the logical unit number dun) which 
is used to identify the file during subsequent operations. 

Unless the process has bypass privilege, it must have read/write 
privilege to the device containing the file, execute privilege to all 
directories in the path leading to the file, read privilege to the 
directory containing the file, and read/write privilege to the file 
itself in order for the file to be successfully opened. If the 
"opdelete" mode bit is set (delete file upon closing) , the process 
must also have delete privilege to the file. 

If fname is specified in the fcb.seq number format, the process must 
have read/write privilege to the device containing the file and read/ 
write privilege to the file itself in order for the file to be 
successfully opened. 

Related Privileges: 

none - Allows opening if process has access to the file as 

described above, 
altuic - Allows opening if the owner of the image file for the 

current process has access as to the file as described 

above, 
bypass - Allows the process to open the file independent of the 

file protection, 
system - Allows opening if the system has access as described 

above. 



Parameters: 
fname 



mode 



Address of a null terminated string containing the 
name of the file to be opened. The string will be 
translated automatically by WMCS to its logical 
equivalence. This string may contain up to 93 
valid characters followed by a null. 
Bit encoded long word specifying the type of access 
required. The following description explains the 
options when the specified bit is set (1) : 
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Bit Name 



Bit # Description 



i . i J 1 * ? <* s H\ * * [ ° 



"U 



t J \ 



Z- 



cD 



S> 



opreadacc 

opwriteacc 

opreadlock 

opwritelock 



opdelete 
opappend 

opfastread 




^ V o^ c 



\J^ ^\ 



10 



Read access - Requests permission 

to read the file. 

Write access - Requests permission 

to write the file. 

Read lock - Requests permission 

for exclusive read access to the 

file. 

Write lock - Requests permission 

for exclusive write access to the 

file. 



Delete - Requests that the file be 
deleted upon closing. 
Append - Specifies that the 
initial file position be at the 
logical end of file. 
Fast read - Specifies that the 
file will be read asynchronously. 
That is, that control returns to 
the user process before the data 
have actually been read. As 
records are read, they will be 
transferred directly into the 
process's logical address space 
bypassing the device cache. This 
bit is only valid for disk class 
devices. Other requirements are 
1) Supports only requests for 
complete sectors only, 2) Process 
buffer must be on a word boundary, 
3) Request cannot cross a 4 Kbyte 
page boundary. Use the __frctoait 
system call to determine when 
asynchronous reads are complete. 
Open next file - On a tape device, 
specifies to open the "next" file 
without^ regard to the filename. 
No read ahead - Specifies that 
read ahead is not to be done on 
the opened file. 

No truncate - Specifies that when 
the file is closed the extra 
physical sectors allocated to the 
file are not to be released. 
Reserved. Must be set to zero. 
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cropenshared 11 



opzerodelete 12 



Open shared - Specifies that if 
the current process or any 
ancestor of the current process 
has a file with the specified 
name (fname) and with the same 
access modes currently open, 
this process will share the file 
with the ancestor, including the 
default file position. As the file 
is read or written, the default 
position is adjusted for both the 
-current^ process and the ancestor. 



reel en 



lun 
status 

Diagnostics : 



Zero delete - Zero each sector of 
the file before deleting the file. 
This bit is only valid if the file 
is being deleted (via cldelete or 
some other way) . 
13-31 Reserved. Must be set to zero. 

- Record length. If this parameter is between 1 and 65534 
inclusive, it overrides the default record length 
specified for the file. Specifying a zero or $FFFFFFFF 
(-1) for this parameter causes the file to be open with 
the default record length. 

- Address of a long word to receive the logical unit number 
of the open file. 

- Address of a long word to receive the result of 
the operation. 



\i 



er rnomemavail ( 7 ) 

errinvdevnam (130) 

errundevnam (131) 

errfilnotfnd (133) 

errreadlock (135) 

errwritelock (136) 

errinvreclen (138) 

errnoexecpriv (143) 

errnoreadpriv (144) 

errnowritepriv (145) 

errnodelpriv (146) 



All available memory has been allocated. 

The specified devicename is syntactically 

incorrect. 

The MCS does not recognize the devicename. 

Is the device mounted? 

The specified file could not be found. 

The specified file is read-locked. 

The specified file is write-locked. 

Edit mode 3 requires that the file's record 

length be set to one. 

The process does not have Execute Privilege 

for the file. 

The process does not have Read Privilege for 

the file. 

The process does not have Write Privilege for " 

the file. 

The process does not have Delete Privilege for 

the file. 



l**V, 



OPEN-3 



Dictionary of WMCS System Calls 
_open 



errinvfnstr 



(147) The specified filename is syntactically 
incorrect. 

The specified directory is not a directory. 
The specified directory name is syntactically 
incorrect, 
errinvcloper (173) The device class is inappropriate for the 

operation. 

The specified directory does not exist. 
The file's PCB.SBQ number in the directory file 
is incorrect. 

The process tried to simultaneously open more 
than one tape file. 



errinvdirfle 
errinvdirstr 



errdirnotfnd 
errdirnotfnd 

errfilopen 



(148) 
(149) 



(177) 
(178) 

(202) 



See Also: 



_close 

_create 

_physio 

_read 

_write 



- Close a file 

- Create a file 

- Perform physical I/O operation 

- Read from on open file 

- Write to an open file 



Assembler Calling Sequence: 

%%sys$disk/sysincl . sys/sysequ. asm 
push f name 
push mode 



push 
push 
push 
jsr 



reel en 
lun 
status 
_open 



; address - file name 
; value - type of access requested 
;value - record length 
; address - logical unit number 
; address - result of the operation 
;open a file 



C Function Declaration: 



♦include "sys$disk/sysincl. sys/sysequ. h" 

/* open a file */ 

long /* returns result of the operation */ 

_open (fname, mode, reel en, lun) 

char fname [94] ; /* file name */ 

long mode; /* type of access requested */ 

long reclen; /* record length */ 

long *lun; /* logical unit number */ 
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Fortran Subroutine Declaration: 



subroutine _open (fname, 
character *94 fname 1 
integer*4 mode i 
integer*4 reclen 1 
integer*4 lun ! 
integer *4 status I 
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! open a file 

mode, reclen r lun, status) 
file name 

type of access requested 
record length 
logical unit number 
result of the operation 



Pascal Procedure Declaration: 



%%sys$disk/sysincl . sys/sysequ. pas 



procedure __open( 
fname 
mode 
reclen 
lun 
var status 

) ; external; 



{** open a file) 
string[93]; {** file name) 
longint; {** type of access requested) 
longint; {** record length) 
longint; {** logical unit number) 
longint {** result of the operation) 
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orevnt - Wait for OR of event flags. 

Description: 

Suspends process execution and waits for any one of a set 
of event flags to be set. When any of the flags is set, 
or when the time out value is exceeded, processing resumes. 

Related Privileges: 



none 

group 
world 
Parameters : 



- Allows waiting on the event flags of any process 
with the same owner id and group id (uic) as the 
calling process. 

- Allows waiting on the event flags of any process 
with the same group id as the calling process. 

- Allows waiting on the event flags of any process, 



pid 

efmask 
timout 
status 



- Process id of the process whose event flags are 

to be monitored. A pid of represents the current 
process. A pid of -1 represents the parent of the 
current process. 

- Event flag mask. The process will be suspended until 
one of the bits in the event flag of that corresponds 
to a one bit in this mask is set. 

- Time out value specified in lOOths of a second. 
Represents the maximum time to wait for one of the 
specified event flags to be set. 

- Address of a long word to receive the result of the 
operation. 



Diagnostics : 

errinsufpriv (1) The process lacks the privileges required to 

perform the operation, 
errprcsnotfnd (2) The specified process is not in the system 

process table, 
errtimeout (128) A request was not completed within the 

specified time. 

See Also: 

__andevnt - Wait for AND of event flags 
_clrevnt - Clear event flags 
_getevnt - Read event flags 
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__setevnt - Set event flags 
Assembler Calling Sequence: 



push 


pid 


push 


efmask 


push 


timout 


push 


status 


jsr 


_orevnt 



C function declaration: 



long 

_orevnt(pid f efmask, timout) 

long pid; 

long efmask; 

long timout; 

Fortran Subroutine Declaration: 



;value - process id 

; value - event flag mask 

; value - time out 

; address - result of the operation 

;wait for OR of event flags 



/* wait for OR of event flags */ 

/* returns result of the operation */ 



/* process id */ 

/* event flag mask */ 

/* time out */ 



! wait for OR of event flags 
subroutine orevnt (pid , efmask, timout. status) 

! process id 
! event flag mask 
! time out 
! result of the operation 



integer*4 pid 
integer* 4 efmask 
integer* 4 timout 
integer* 4 status 



Pascal Procedure Declaration: 



procedure orevnt ( 



pid 


: longint; 


efmask 


: longint; 


timout 


: longint; 


var status 


: longint 


) ; external; 





{** wait for OR of event flags} 

{** process id} 

{** event flag mask} 

{** time out value} 

{** result of the operation} 
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_QRIGPRV 
Get original process privileges- 
Description: 

Allows a process to inspect the privileges assigned to a process 
before any installed privileges were added at process creation time. 

Related Privileges: 

None. 

Parameters: 

pid - Process 3D of the process whose original privileges 

are to be returned. A PID of represents the current 
process. A PID of -1 represents the parent of the 
current process. 

priv - Address of a long word to receive the original privilege 
mask containing a bit mask of privileges assigned 
to the specified process. 





Bit Name Bit 


# Description 




pcbpvsetpriv 


setpriv 




pcbpvsystem 1 


system 




pctpvreadphys 2 


readphys 




pcbpvwritephys 3 


writephys 




pcbpvsetprior 4 


setprior 




pcbpvchngsuper 5 


chngsuper 




pcbpvbypass 6 


bypass 




pcbpvoperator 7 


operator 




pcbpvaltuic 8 


altuic 




pcbpvworld 9 


world 




pcbpvgroup 10 


group 




pcbpvnetwork 11 


network 




pcbpvsetattr 12 


setattr 




13-: 


32 Reserved. 


status 


- Address of a longword to receive the result of 


i 2*rmr\G!^ i /^e • 


the operation. 




JL&^IlvJoL-Xv^o • 

errprcsnotfnd (2) The specified process is not in the s 



process table. 
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See Also: 



__crproc - Create a new process 
__getpri - Get process priority 
_getprv - Get process privileges 
_gettmsl - Get scheduling time slice 
..install - Install a privileged file 
_setpri - Set process priority 
_setprv - Set process privilege 
_settmsl - Change scheduling time slice 



Assembler Calling Sequence: 



push 
push 
push 
jsr 



pid 
priv 
status 
_origprv 



C Function Declaration: 



long 
_origprv(pid, priv) 

long pid; 

long *priv; 

FORERAN Subroutine Declaration: 



;value - process id 
;address - privilege mask 
/address - result of the operation 
;get original process privileges 



/* get original process privilege */ 
/* returns result of the operation */ 



/* process id */ 
/* privilege mask */ 



! get original process privilege 
subroutine «prigpr (pid, priv, status) 



integer*4 pid 
integer*4 priv 
integer*4 status 

Pascal Procedure Declaration: 

procedure _origprv( 

pid : longint; 

var priv : longint; 

var status : longint 
) ; external; 



i process id 

i privilege mask 

1 result of the operation 



{** get original process privilege) 

{** process id} 

{** privilege mask) 

{** result of the operation} 
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physio 



physio - Perform physical I/O operation. 
Description: 

Performs a direct call to the device driver associated 

with a successfully opened file or device bypassing the file 

structure. Allows physical I/O on mounted devices. 

The device may be mounted as a 'special 1 (e.g. diskspc) . 

This is similar to physop, except with this call the device 
is identified by a logical unit number as opposed to a 
device name. Accesses via logical unit number are 
faster than accesses via device name. 

To successfully perform the operation, the calling process 
must have read or write privilege to the device (depending 
on the operation) and either be the owner of the device (the 
process uic and the device uic are the same) or have readphys 
or writephys privilege (depending on the operation) . 

Related Privileges: 

none - Allows the process to access the device if the owner 
id and group id (uic) of the process are the same as 
the uic of the device and the process has read/write 
privilege as described above. 

altuic - Allows the process to access the device if the owner 
of the image file for the current process has access 
to the device as described above. 

bypass - Allows the process to access the device independent 

of the file protection. This does not obviate the need 
for either readphys or writephys privilege. This only 
applies to read or write privilege to the device. 

readphys - Allows physical access for read operations to devices 

as described above. This does not obviate the need for 
either read or write privilege to the device. 

system - Allows the process to access the device if the system 
has access to the device as described above. This 
does not obviate the need for either readphys or 
writephys privilege. This only applies to read or 
write privilege to the device. 

writephys - Allows physical access for write operations to devices 
as described above. This does not obviate the need 
for either read or write privilege to the device. 

Parameters : 
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lun - A long word containing the logical unit number 
of the device to which the I/O operation is to 
be performed. 

func - Which operation to perform. Valid operations 

are: (Note that some of the commands are device class 

specific. When ever a class is specified, it also 

applies to the special form of that class. Commands 

described for tty class devices also apply to pipe, sync, 

and nondev class devices.) 

The names of these functions are defined in the 

file /sysincl.sys/contcmd.* 

Read from the device 
(2) diskreadcmd 
(2) taper eadcmd 

(2) ttyr eadcmd 

This will read the specified number of blocks 
from the given device. This command is valid 
on this list of devices: Disk, Nondev, Pipe, 
Sync, Tape, TK. 

Requires read privilege to the device, and if 
the calling process is not the owner of the 
device, also requires readphys privilege, 
unless this is a nondev class device, 
parml - Address of a buffer to receive the 
data read. This buffer must be 
word aligned. 
parm2 - A long word containing the block 

number of the first block to be read. 
This parameter is not used for tape 
or tty class devices. 
parm3 - A long word containing the number 

of blocks to read. On tape devices, 
this parameter represents how many 
bytes to read. On tapes, this function 
will never read more than one block. 
parm4 - Address of a long word to receive 
the number of blocks actually read. 

Write to the device 

(3) diskwritecmd 
(3) tapewritecmd 
(3) ttywritecmd 

This will write the specified number of blocks 
to the given device. This command is valid 
on this list of devices: Disk, Nondev, Pipe, 
Sync, Tape, TTZ. 
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Requires write privilege to the device, and if 
the calling process is not the owner of the 
device, also requires writephys privilege, 
unless this is a nondev class device, 
parml - Address of a buffer containing data 
to be written. This buffer must be 
word aligned. 
parm2 - A long word containing the block 
number of the first block to be 
written. This parameter is not used 
for tape or tty class devices. 
parm3 - A long word containing 

the number of blocks to write. 
On tape devices, this parameter 
represents the number of bytes to 
write. 
parm4 - Address of a long word to receive 

the number of blocks actually written, 



Format the device 

(4) diskformatcmd 



Reformat the given media. This command is valid 
on this list of devices: Disk. 

Requires write privilege to the device, and if 
the calling process is not the owner of the 
device, also requires writephys privilege. 

parml - Not used. 

parm2 - Not used. 

parm3 - Not used. 

parm4 - Not used. 



Erase the device 

(4) tapeerasecmd 



Erase the data off of the given device. This 
command is valid on this list of devices: 
Tape. 

Requires write privilege to the device, and if 
the calling process is not the owner of the 
device, also requires writephys privilege, 
parml - A long word containing sub function 
number: 

(0) tapeerstartvar - Variable length 
erase start. 

(1) tapeerstopvar - Variable length 
erase stop. 

(2) tapeersecurity - Security erase. 
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(3) tapeerfixedlen - Fixed length erase. 
parm2 - Not used. 
parm3 - Not used. 
parm4 - Not used. 

Purge input buffer (Not implemented) 

(4) ttypurgeinputbuffer 

This will delete all data in the input typeahead 
buffer. This command is valid on this list of 
devices: Nondev, Pipe, Sync, TTf. 

Requires write privilege to the device, and 
if the calling process is not the owner of 
the device, also requires writephys privilege, 
unless this is a nondev class device. 

parml - Not used. 

parm2 - Not used. 

parm3 - Not used. 

parm4 - Not used. 

Read device status 

(5) diskgetstatuscmd 
(5) tapegetstatuscmd 
(5) ttygetstatuscmd 

(5) quegetstatuscmd 

This will read the device status from the given 
device. This command is valid on this list of 
devices: Disk, Nondev, Pipe, Queue, Sync, 
Tape, TIY. 

Requires read privilege to the device, and if 
the calling process is not the owner of the 
device, also requires readphys privilege, 
unless this is a nondev class device. 

parml - Address of a 128 byte buffer to 
receive the device status. This 
buffer must be word aligned. 

parm2 - Not used. 

parm3 - Not used. 

parm4 - Not used. 

Set device status 

(6) disksetstatuscmd 
(6) tapesetstatuscmd 
(6) ttysetstatuscmd 
(6) quesetstatuscmd 

This will set the device status on the given 
device. This command is valid on this list of 
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devices: Disk, Nondev, Pipe, Queue, Sync f 
Tape, TIY. 

Requires write privilege to the device, and if 
the calling process is not the owner of the 
device, also requires writephys privilege, 
unless this is a nondev class device, 

parml - Address of a 128 byte buffer containing 
the new device status. This buffer 
must be word aligned. 

parm2 - Not used. 

parm3 - Not used. 

parm4 - Not used. 

Format specified track (s) (Not implemented) 
(7) diskformattrackcmd 

This will format a given list of tracks on the 
device. This command is valid on this list of 
devices : Disk . 

Requires write privilege to the device, and if 
the calling process is not the owner of the 
device, also requires writephys privilege, 
parml - A long word containing 

the cylinder number. 
parm2 - A long word containing 

the head number. 
parm3 - A long word containing 

the number of cylinders to format. 
parm4 - Address of a long word to receive the 
number of cylinders actually formatted. 

Skip, position the device. 
(7) tapeskipcmd 

Skip to the specified position on the device. 
This command is valid on this list of devices: 
Tape. 

Requires read privilege to the device, and if 
the calling process is not the owner of the 
device, also requires readphys privilege, 
parml - A long word containing 

subf unction number (type of skip) : 

(0) tapeskiprecords - Skip records 

(1) tapeskipf iles - Skip files 

(2) tapeskipbot - Skip to beginning of 
volume 

(3) tapeskipeot - Skip to end of volume 
parm2 - Not used. 
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parm3 - A long word containing 

the number of units to skip. 
If parntl specifies a skip to beginning 
of volume then this parameter indicates 
whether the tape should be positioned 
before or after the volume label. 

(0) tapeskipbefheader - Leave tape 
positioned before the volume label, 
(load point) 

(1) tapeskipaftheader - Leave tape 
positioned after the volume label, 
(the position the tape would 
normally be at after a mount. 

parm4 - Address of a long word to receive the 
number of units actually skipped. 



Dial a modem 

(7) ttydialcmd 



With the given string this will dial out on 
the given device. This command is valid on 
this list of devices: Nondev, Pipe, Sync, TIY. 

Requires write privilege to the device, and if 
the calling process is not the owner of the 
device, also requires writephys privilege, 
unless this is a nondev class device, 
parml - Address of a dial buffer. Contains 
characters meaningful to the device. 
Representing the number to be dialed. 
parm2 - Not used. 
parm3 - The number of bytes to be used in the 

dial buffer. 
parm4 - Not used. 



Insert an entry into the device 
(7) queenquecmd 



This will insert a given create process record 
into the queue for execution at the correct 
time. This command is valid on this list of 
devices : Queue . 

Requires write privilege to the device. 

parml - Address of the queue create process 

buffer. 
parm2 - Address of the queue entry buffer. 
parm3 - Not used. 

parm4 - Address of a longword to receive the 
queue entry number. 
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Set drive configuration table 
(8) disksetdrivetblcmd 



This will define a new drive configuration 
table for this device. This describes the 
media to the driver. This command is valid on 
this list of devices: Disk, 

Requires write privilege to the device, and if 
the calling process is not the owner of the 
device, also requires writephys privilege. 

parml - Address of the new drive configuration 
table. 

parm2 - Not used. 

parm3 - Not used. 

parm4 - Not used. 



Write tape mark 

(8) tapewritetapemark 



Write a tape mark on the given device. This 
command is valid on this list of devices: Tape. 

Requires write privilege to the device, and if 
the calling process is not the owner of the 
device, also requires writephys privilege. 

parml - Not used. 

parm2 - Not used. 

parm3 - Not used. 

parm4 - Not used. 

Hangup a modem 

( 8) ttyhangupcmd 

This will send a hangup command out to the given 
device. This command is valid on this list of 
devices: Nondev, Pipe, Sync, TTY. 

Requires write privilege to the device, and if 
the calling process is not the owner of the 
device, also requires writephys privilege, 
unless this is a nondev class device. 

parml - Not used. 

parm2 - Not used. 

parm3 - Not used. 

parm4 - Not used. 

Get entry information by index number 
(8) quelistcmd 

This will receive all of the information about 
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a given entry in the queue. It will access that 
entry by the current index from the front of 
the queue. This command is valid on this list 
of devices: Queue. 

Requires read privilege to the device, 
parml - Index number from front of file for 

which entry we want. 
parm2 - Address of buffer to receive the queue 

create process buffer. 
parm3 - Address of buffer to receive the queue 

entry buffer. 
parm4 - Address of a longword to receive this 

entry's entry number. 



Set [CONTROL] C pid 

(9) ttysetcontcpid 



This will specify that the calling process 
is to be terminated on the next [CONTROL] C 
character that is received. This command is 
valid on this list of devices: Nondev, Pipe, 
Sync, TTY. 

Requires write privilege to the device, and if 
the calling process is not the owner of the 
device, also requires writephys privilege, 
unless this is a nondev class device. 

parml - Not used. 

parm2 - Not used. 

parm3 - Not used. 

parm4 - Not used. 



Delete an entry from the device 
(9) quedequecmd 



This will delete the given entry from the 
queue. This command is valid on this list of 
devices : Queue . 

Requires write privilege to the device. 
Requires that the entry have the same owner id 
and group id as the caller . or the same group 
id as the caller and the caller has group 
privilege, or the caller has world privilege. 

parml - Entry number of which entry to delete, 

parm2 - Not used. 

parm3 - Not used. 

parm4 - Not used. 



PHYSIO-8 



Dictionary of WMCS System Calls 

physio 



Reset the device 

(10) ttyresetcmd 



This will reset the device. This command is 
valid on this list of devices: Nondev, Pipe, 
Sync, TK. 

Requires write privilege to the device, and if 
the calling process is not the owner of the 
device, also requires writephys privilege, 
unless this is a nondev class device. 

parml - Not used. 

parm2 - Not used. 

parm3 - Not used. 

parm4 - Not used. 



Halt the device 

(10) quehaltcmd 



This will halt the given queue. This means 
that no more entries will be executed. 
Entries can still be added to the queue. 
This command is valid on this list of devices: 
Queue . 

Requires write privilege to the device, and if 
the calling process is not the owner of the 
device, also requires operator privilege. 

parml - Not used. 

parm2 - Not used. 

parm3 - Not used. 

parm4 - Not used. 



Start the device after a halt 
(11) questartcmd 



This will start the queue after a halt command 
has been given. This means that ready entries 
will be executed. This command is valid on 
this list of devices: Queue. 

Requires write privilege to the device, and if 
the calling process is not the owner of the 
device, also requires operator privilege. 

parml - Not used. 

parm2 - Not used. 

parm3 - Not used. 

parm4 - Not used. 



Restart an entry on the device 
(12) querestartcmd 
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This will take an entry that is already 
executing and will terminate the process. It 
will then restart the entry. This command is 
valid on this list of devices: Queue. 

Requires write privilege to the device. 
Requires that the entry have the same owner id 
and group id as the caller, or the same group 
id as the caller and the caller has group 
privilege , or the caller has world privilege. 

parml - Entry number of which entry to restart. 

parm2 - Not used. 

parm3 - Not used. 

parm4 - Not used. 



Send a break character 
(13) ttysendbreak 



This will send a break character out of the given 
device. This command is valid on this list of 
devices: Nondev, Pipe, Sync, TIY. 

Requires write privilege to the device, and if 
the calling process is not the owner of the 
device, also requires writephys privilege, 
unless this is a nondev class device. 

parml - Not used. 

parm2 - Not used. 

parm3 - Not used. 

parm4 - Not used. 



Wait for an entry to complete 
(13) quewaitcmd 



This will wait for the given entry to complete. 
If the entry does not exist, it will return 
immediatly. This command is valid on this list 
of devices: Queue 

Requires read privilege to the device, 
parml - Entry number of which entry to wait on. 
parm2 - Not used. 
parm3 - Not used. 
parm4 - Not used. 



Hold an entry on the device 
(15) queholdcmd 



This will hold the given entry. This means 
that it will not be executed. This command is 
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valid on this list of devices: Queue. 

Requires write privilege to the device. 
Requires that the entry have the same owner id 
and group id as the caller » or the same group 
id as the caller and the caller has group 
privilege, or the caller has world privilege. 

parml - Entry number of which entry to hold. 

parm2 - Not used. 

parm3 - Not used. 

parm4 - Not used. 



Wake an entry after a hold command 
(16) quewakecmd 



This will wake the given entry after a hold 
command. This means the entry is available 
for execution again. This command is valid on 
this list of devices: Queue. 

Requires write privilege to the device. 
Requires that the entry have the same owner id 
and group id as the caller* or the same group 
id as the caller and the caller has group 
privilege, or the caller has world privilege. 

parml - Entry number of which entry to wake. 

parm2 - Not used. 

parm3 - Not used. 

parm4 - Not used. 



Modify an entry on the device 
(18) quemodifycmd 



This will modify an entry that is already 
queued. This command is valid on this list 
of devices: Queue. 

Requires write privilege to the device. 
Requires that the entry have the same owner id 
and group id as the caller, or the same group 
id as the caller and the caller has group 
privilege, or the caller has world privilege. 

parml - Entry number of which entry to modify. 

parm2 - Address of the new queue create 
process buffer. 

parm3 - Address of the new queue entry buffer. 

parm4 - Not used. 



Close the given device 
(19) queclosecmd 
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This will close the queue. This means that no 
more entries can be entered into the queue. 
Entries that have already been queued will 
continue to be executed as their turn arrives. 
This command is valid on this list of devices: 
Queue. 

Requires write privilege to the device, and if 
the calling process is not the owner of the 
device, also requires operator privilege. 

parml - Not used. 

parm2 - Not used. 

parra3 - Not used. 

parm4 - Not used. 

Open the given device after a close 

(20) queopencmd 

This will open the queue after a close command. 
This means that more entries may be queued. 
This command is valid on this list of devices: 
Queue . 

Requires write privilege to the device, and if 
the calling process is not the owner of the 
device, also requires operator privilege. 

parml - Not used. 

parm2 - Not used. 

parm3 - Not used. 

parm4 - Not used. 

Get entry information by entry number 

(21) quegetentrycmd 

This will receive all of the information about 
a given entry in the queue. It will access 
that entry by entry number. This command is 
valid on this list of devices: Queue. 

Requires read privilege to the device. 

parml - Entry number of which entry to get. 
parm2 - Address of buffer to receive the queue 

create process buffer. 
parm3 - Address of buffer to receive the queue 

entry buffer. 
parm4 - Address of a longword to receive this 

entry's entry number. 

Get default create process record 

(22) quegetdefcrpcmd 
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This will get the default create process record. 
This record is .used when a user redirects output 
directly to the queue device. This command is 
valid on this list of devices: Queue. 

Requires read privilege to the device, 
parml - Address of buffer to receive the 

default queue create process record. 
parm2 - Not used. 
parm3 - Not used. 
parm4 - Not used. 

Set default create process record 
(23) quesetdefcrpcmd 

This will set the default create process record. 
This record is used when a user redirects output 
directly to the queue device. This command is 
valid on this list of devices: Queue. 

Requires write privilege to the device, and if 
the calling process is not the owner of the 
device, also requires operator privilege. 

parml - Address of the new default queue 
create process buffer. 

parm2 - Not used. 

parm3 - Not used. 

parm4 - Not used. 

- Maximum amount of time to wait for the operation 
to complete. Expressed in 100'ths of a second 

- A parameter defined by the function 

- A parameter defined by the function 

- A parameter defined by the function 

- A parameter defined by the function 

- Address of a long word to receive the result of 
the operation. 



Diagnostics : 

errinsufpriv 

errtimeout 

errinvdevnam 

errundevnam 

errinvcloper 

errprevinit 



(1) The process lacks the privileges required to 

perform the operation. 
(128) A request was not completed within the 
specified time. 

(130) The specified devicename is syntactically 
incorrect. 

(131) The MCS does not recognize the devicename. 
Is the device mounted? 

(173) The operation is inappropriate for the 

device class. 
(188) The specified device is already mounted, 
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errinvskpcmd (206) 
errinvdrvnum (311) 



and has another name. 

The specified skip or erase tape-function is 

undefined. 

A value in at least one field of the devicename 

is disallowed. 

Device errors 



See Also: 



_dismnt - 
_getdnam- 
_getdst - 
_giodst - 
_mount - 
_open 
_physop - 
_setdst - 
_siodst - 
_skip 



Dismount a logical device 

Get device name 

Get device status 

Get device status with lun 

Mount a logical device 

Open a file 

Perform physical device operation 

Set device status 

Set device status with lun 

Position tape 



Assembler Calling Sequence: 

%%sys$disk/sysincl . sys/sysequ.asm 

push lun 

push func 

push timout 

push parml 

push parm2 

push parm3 

push parm4 

push status 

jsr _physio 

C function declaration: 



; value - logical unit number 

; value - which function 

; value - time out 

; address/ value - 1st parameter 

; address/value - 2nd parameter 

; address/value - 3rd parameter 

; address/value - 4th parameter 

; address - result of the operation 

;perform physical I/O operation 



^include n sys$disk/sysincl.sys/sysequ.h" 

/* perform physical I/O operation */ 
/* returns result of the operation */ 
parm2, parm3, parm4) 
/* logical unit number */ 



timout* parml 



long 
_physio(lun, func, 

long lun; 

long func; 

long timout; 

long parml; 

long parm2; 

long parm3; 

long parm4; 



Fortran Subroutine Declaration: 



/* 
/* 
/* 
/* 
/* 
/* 



which function */ 
time out */ 
1st parameter */ 
2nd parameter */ 
3rd parameter */ 
4th parameter */ 



1 perform physical I/O operation 
subroutine physio ( lun , func, timout, parml, parm2, 
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integer*4 lun 
integer* 4 func 
integer*4 timout 
integer*4 parml 
integer*4 parm2 
integer*4 parm3 
integer*4 parm4 
integer*4 status 

Pascal Procedure Declaration: 



parm3, parm4, status] 



logical unit number 

which function 

time out 

1st parameter 

2nd parameter 

3rd parameter 

4th parameter 

result of the operation 



Note that all of the parm components are defined as long integers.. 
Where the address of a variable is to be passed, use the following 
function. _physio ( . . . f cast (vice (variable) , longint) , . . . ) 



%%sys$disk/sysincl . sys/sysequ.pas 
procedure physio ( 



lun 


: longint; 


func 


• longint; 


timout 


• longint; 


parml : 


longint; 


parm2 : 


• longint; 


parm3 


: longint; 


parm4 


: longint; 


var status 


: longint 


) ; external ; 





{** perform physical I/O operation} 

{** logical unit number} 

{** which function} 

{** timeout value} 

{** 1st parameter} 

{** 2nd parameter} 

{** 3rd parameter} 

{** 4th parameter} 

{** result of the operation} 
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physop - Perform physical device operation. 

Description: 

Performs a direct call to the device driver of the 
named device bypassing the file structure. Allows 
physical I/O on mounted devices. The device may 
be mounted as a 'special' (e.g. diskspc) . 

To successfully perform the operation, the calling process 
must have read or write privilege to the device (depending 
on the operation) and either be the owner of the device (the 
process uic and the device uic are the same) or have readphys 
or writephys privilege (depending on the operation) . 

For the nondev and nondevspc class devices, the readphys and 
writephys privilege are not required. 

Related Privileges: 

none - Allows the process to access the device if the owner 
id and group id (uic) of the process are the same as 
the uic of the device and the process has read/write 
privilege as described above. Or the class is nondev 
or nondevspc. 

altuic - Allows the process to access the device if the owner 
of the image file for the current process has access 
to the device as described above. 

bypass - Allows the process to access the device independent 

of the file protection. This does not obviate the need 
for either readphys or writephys privilege. This only 
applies to read or write privilege to the device. 

readphys - Allows physical access for read operations to devices 
as described above. This does not obviata the need for 
either read or write privilege to the device. 

system - Allows the process to access the device if the system 
has access to the device as described above. This 
does not obviate the need for either readphys or 
writephys privilege. This only applies to read or 
write privilege to the device. 

writephys - Allows physical access for write operations to devices 
as described above. This does not obviate the need 
for either read or write privilege to the device. 

Parameters : 
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dname - Address of null terminated string containing 
the name of the device involved. This string 
is translated automatically by the MCS to its 
logical equivalent. This string may contain up 
to 93 significant characters followed by a null. 
If this string contains a file designation* the 
devicename portion of the file designation is used for 
this parameter. 

func - Which operation to perform. Valid operations 

are: (Note that some of the commands are device class 

specific. When ever a class is specified, it also 

applies to the special form of that class. Commands 

described for tty class devices also apply to pipe, sync, 

and nondev class devices.) 

The names of these functions are defined in the 

file /sysincl.sys/contcmd.* 

Read from the device 
(2) diskreadcmd 
(2) tapereadcmd 

(2) ttyreadcmd 

This will read the specified number of blocks 
from the given device. This command is valid 
on this list of devices: Disk, Nondev, Pipe, 
Sync, Tape, TOT. 

Requires read privilege to the device, and if 
the calling process is not the owner of the 
device, also requires readphys privilege, 
unless this is a nondev class device, 
parml - Address of a. buffer to receive the 
data read. This buffer must be 
word aligned. 
parm2 - A long word containing the block 

number of the first block to be read. 
This parameter is not used for tape 
or tty class devices. 
parm3 - A long word containing the number 

of blocks to read. On tape devices, 
this parameter represents how many 
bytes to read. On tapes, this function 
will never read more than one block. 
parm4 - Address of a long word to receive 
the number of blocks actually read. 

Write to the device 

(3) diskwritecmd 
(3) tapewritecmd 
(3) ttywritecmd 
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This will write the specified number of blocks 
to the given device. This command is valid 
on this list of devices: Disk, Nondev, Pipe, 
Sync, Tape, TT3T. 

Requires write privilege to the device, and if 
the calling process is not the owner of the 
device, also requires writephys privilege, 
unless this is a nondev class device, 
parml - Address of a buffer containing data 
to be written. This buffer must be 
word aligned. 
parm2 - A long word containing the block 
number of the first block to be 
written. This parameter is not used 
for tape or tty class devices. 
parm3 - A long word containing 

the number of blocks to write. 
On tape devices, this parameter 
represents the number of bytes to 
write - 
parm4 - Address of a long word to receive 

the number of blocks actually written. 



Format the device 

(4) diskformatcmd 



Reformat the given media. This command is valid 
on this list of devices: Disk. 

Requires write privilege to the device, and if 
the calling process is not the owner of the 
device, also requires writephys privilege. 

parml - Not used. 

parm2 - Not used. 

parm3 - Not used. 

parm4 - Not used. 



Erase the device 

(4) tapeerasecmd 



Erase the data off of the given device. This 
command is valid on this list of devices: 
Tape. 

Requires write privilege to the device, and if 
the calling process is not the owner of the 
device, also requires writephys privilege, 
parml - A long word containing subfunction 
number: 
(0) tapeerstartvar - Variable length 
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erase start. 

(1) tapeerstopvar - Variable length 
erase stop. 

(2) tapeersecurity - Security erase. 

(3) tapeerfixedlen - Fixed length erase. 
parm2 - Not used. 

pann3 - Not used. 
parm4 - Not used. 

Purge input buffer (Not implemented) 

(4) ttypurgeinputbuffer 

This will delete all data in the input typeahead 
buffer. This command is valid on this list of 
devices: Nondev, Piper Sync, TTY. 

Requires write privilege to the device, and 
if the calling process is not the owner of 
the device, also requires writephys privilege, 
unless this is a nondev class device. 

parml - Not used. 

parm2 - Not used. 

parm3 - Not used. 

parm4 - Not used. 

Read device status 

(5) diskgetstatuscmd 
(5) tapegetstatuscmd 
(5) ttygetstatuscmd 

(5) quegetstatuscmd 

This will read the device status from the given 
device. This coirarand is valid on this list of 
devices: Disk, Nondev, Pipe, Queue, Sync, 
Tape, TTY. 

Requires read privilege to the device, and if 
the calling process is not the owner of the 
device, also requires readphys privilege, 
unless this is a nondev class device. 

parml - Address of a 128 byte buffer to 
receive the device status. This 
buffer must be word aligned. 

parm2 - Not used. 

parm3 - Not used. 

parm4 - Not used. 

Set device status 

(6) disksetstatuscmd 
(6) tapesetstatuscmd 
(6) ttysetstatuscmd 
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(6) quesetstatuscmd 

This will set the device status on the given 
device. This command is valid on this list of 
devices: Disk, Nondev, Pipe, Queue , Sync, 
Tape, rar. 

Requires write privilege to the device, and if 
the calling process is not the owner of the 
device, also requires writephys privilege , 
unless this is a nondev class device. 

parml - Address of a 128 byte buffer containing 
the new device status. This buffer 
must be word aligned. 

parm2 - Not used. 

parm3 - Not used. 

parm4 - Not used. 

Format specified track (s) (Not implemented) 

(7) diskformattrackcmd 

This will format a given list of tracks on the 
device. This command is valid on this list of 
devices : Disk . 

Requires write privilege to the device, and if 
the calling process is not the owner of the 
device, also requires writephys privilege, 
parml - A long word containing 

the cylinder number. 
parm2 - A long word containing 

the head number. 
parm3 - A long word containing 

the number of cylinders to format. 
parm4 - Address of a long word to receive the 
number of cylinders actually formatted. 

Skip, position the device. 
(7) tapeskipcmd 

Skip to the specified position on the device. 
This command is valid on this list of devices: 
Tape. 

Requires read privilege to the device, and if 
the calling process is not the owner of the 
device, also requires readphys privilege, 
parml - A long word containing 

sub function number (type of skip) : 

(0) tapeskiprecords - Skip records 

(1) tapeskipfiles - Skip files 
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(2) tapeskipbot - Skip to beginning of 
volume 

(3) tapeskipeot - Skip to end of volume 
parm2 - Not used. 

parm3 - A long word containing 

the number of units to skip. 
If parml specifies a skip to beginning 
of volume then this parameter indicates 
whether the tape should be positioned 
before or after the volume label. 

(0) tapeskipbefheader - Leave tape 
positioned before the volume label. 
(load point) 

(1) tapeskipaftheader - Leave tape 
positioned after the volume label. 
(the position the tape would 
normally be at after a mount. 

parm4 - Address of a long word to receive the 
number of units actually skipped. 



Dial a modem 

(7) ttydialcmd 



With the given string this will dial out on 
the given device. This command is valid on 
this list of devices: Nondev, Pipe, Sync, THY. 

Requires write privilege to the device, and if 
the calling process is not the owner of the 
device, also requires writephys privilege, 
unless this is a nondev class device, 
parml - Address of a dial buffer. Contains 
characters meaningful to the device. 
Representing the number to be dialed. 
parm2 - Not used. 
parm3 - The number of bytes to be used in the 

dial buffer. 
parm4 - Not used. 



Insert an entry into the device 
(7) queenquecmd 



This will insert a given create process record 
into the queue for execution at the correct 
time. This command is valid on this list of 
devices: Queue. 

Requires write privilege to the device. 

parml - Address of the queue create process 

buffer . 
parm2 - Address of the queue entry buffer. 



PHYSOP-6 



Dictionary of WMCS System Calls 

physop 



parm3 - Not used. 

parm4 - Address of a longword to receive the 
queue entry number. 



Set drive configuration table 
(8) disksetdrivetblcmd 



This will define a new drive configuration 
table for this device. This describes the 
media to the driver- This command is valid on 
this list of devices: Disk. 

Requires write privilege to the device, and if 
the calling process is not the owner of the 
device, also requires writephys privilege. 

parml - Address of the new drive configuration 
table. 

parm2 - Not used. 

parm3 - Not used. 

parm4 - Not used. 



Write tape mark 

(8) tapewritetapemark 



Write a tape mark on the given device. This 
command is valid on this list of devices: Tape. 

Requires write privilege to the device, and if 
the calling process is not the owner of the 
device, also requires writephys privilege. 

parml - Not used. 

parm2 - Not used. 

parm3 - Not used. 

parm4 - Not used. 



Hangup a modem 

(8) ttyhangupcmd 



This will send a hangup command out to the given 
device. This command is valid on this list of 
devices: Nondev, Pipe, Sync, TTY. 

Requires write privilege to the device, and if 
the calling process is not the owner of the 
device, also requires writephys privilege, 
unless this is a nondev class device. 

parml - Not used. 

parm2 - Not used. 

parm3 - Not used. 

parm4 - Not used. 
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Get entry information by index number 

(8) quelistcmd 

This will receive all of the information about 
a given entry in the queue. It will access that 
entry by the current index from the front of 
the queue. This command is valid on this list 
of devices: Queue. 

Requires read privilege to the device. 
parml - Index number from front of file for 

which entry we want. 
parm2 - Address of buffer to receive the queue 

create process buffer. 
parm3 - Address of buffer to receive the queue 

entry buffer - 
parm4 - Address of a longword to receive this 

entry's entry number. 

Set [CONTRCL] C pid 

(9) ttysetcontcpid 

This will specify that the calling process 
is to be terminated on the next [CONTRCL] C 
character that is received. This command is 
valid on this list of devices: Nondev, Pipe, 
Sync, nx. 

Requires write privilege to the device, and if 
the calling process is not the owner of the 
device, also requires writephys privilege, 
unless this is a nondev class device. 

parml - Not used. 

parm2 - Not used. 

parm3 - Not used. 

parm4 - Not used. 

Delete an entry from the device 
(9) quedequecmd 

This will delete the given entry from the 
queue. This command is valid on this list of 
devices: Queue. 

Requires write privilege to the device. 
Requires that the entry have the same owner id 
and group id as the caller, or the same group 
id as the caller and the caller has group 
privilege, or the caller has world privilege. 

parml - Entry number of whicn eiitry to delete. 
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parm2 - Not used, 
parm3 - Not used. 
parm4 - Not used. 



Reset the device 

(10) ttyresetcmd 



This will reset the device. This command is 
valid on this list of devices: Nondev, Pipe, 
Sync, TK # 

Requires write privilege to the device, and if 
the calling process is not the owner of the 
device, also requires writephys privilege, 
unless this is a nondev class device. 

parml - Not used. 

parm2 - Not used. 

parm3 - Not used. 

parm4 - Not used. 



Halt the device 

(10) quehaltcmd 



This will halt the given queue. This means 
that no more entries will be executed. 
Entries can still be added to the queue. 
This command is valid on this list of devices: 
Queue. 

Requires write privilege to the device, and if 
the calling process is not the owner of the 
device, also requires operator privilege. 

parml - Not used. 

parm2 - Not used. 

parm3 - Not used. 

parm4 - Not used. 



Start the device after a halt 
(11) questartcmd 



This will start the queue after a halt command 
has been given. This means that ready entries 
will be executed. This command is valid on 
this list of devices: Queue. 

Requires write privilege to the device, and if 
the calling process is not the owner of the 
device, also requires operator privilege. 

parml - Not used. 

parm2 - Not used. 

parm3 - Not used. 
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parm4 - Not used. 



Restart an entry on the device 
(12) querestartcmd 



This will take an entry that is already 
executing and will terminate the process. It 
will then restart the entry. This command is 
valid on this list of devices: Queue. 

Requires write privilege to the device. 
Requires that the entry have the same owner id 
and group id as the caller . or the same group 
id as the caller and the caller has group 
privilege, or the caller has world privilege. 

parml - Entry number of which entry to restart. 

parm2 - Not used. 

parm3 - Not used. 

parm4 - Not used. 



Send a break character 
(13) ttysendbreak 



This will send a break character out of the given 
device. This command is valid on this list of 
devices: Nondev, Pipe, Sync, TTY. 

Requires write privilege to the device, and if 
the calling process is not the owner of the 
device, also requires writephys privilege, 
unless this is a nondev class device. 

parml - Not used. 

parm2 - NOt used. 

parm3 - Not used. 

parm4 - Not used. 



Wait for an entry to complete 
(13) quewaitcmd 



This will wait for the given entry to complete. 
If the entry does not exist, it will return 
immediatly. This command is valid on this list 
of devices: Queue 

Requires read privilege to the device, 
parml - Entry number of which entry to wait on. 
parm2 - Not used. 
parm3 - Not used. 
parm4 - Not used. 



Hold an entry on the device 
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(15) queholdcmd 



This will hold the given entry. This means 
that it will not be executed. This command is 
valid on this list of devices: Queue. 

Requires write privilege to the device. 
Requires that the entry have the same owner id 
and group id as the caller- or the same group 
id as the caller and the caller has group 
privilege, or the caller has world privilege. 

parml - Entry number of which entry to hold. 

parm2 - Not used. 

parm3 - Not used. 

parm4 - Not used. 



Wake an entry after a hold command 
(16) quewakecmd 



This will wake the given entry after a hold 
command. This means the entry is available 
for execution again. This command is valid on 
this list of devices: Queue. 

Requires write privilege to the device. 
Requires that the entry have the same owner id 
and group id as the caller, or the same group 
id as the caller and the caller has group 
privilege, or the caller has world privilege. 

parml - Entry number of which entry to wake. 

parm2 - Not used. 

parm3 - Not used. 

parm4 - Not used. 



Modify an entry on the device 
(18) quemodifycmd 



This will modify an entry that is already 
queued. This command is valid on this list 
of devices: Queue. 

Requires write privilege to the device. 
Requires that the entry have the same owner id 
and group id as the caller, or the same group 
id as the caller and the caller has group 
privilege, or the caller has world privilege. 

parml - Entry number of which entry to modify, 

parm2 - Address of the new queue create 
process buffer. 

parm3 - Address of the new queue entry buffer, 

parm4 - Not used. 
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Close the given device 
(19) queclosecmd 



This will close the queue. This means that no 
more entries can be entered into the queue. 
Entries that have already been queued will 
continue to be executed as their turn arrives. 
This command is valid on this list of devices: 
Queue . 

Requires write privilege to the device, and if 
the calling process is not the owner of the 
device, also requires operator privilege. 

parml - Not used. 

parm2 - Not used. 

parm3 - Not used. 

parm4 - Not used. 



Open the given device after a close 

(20) queopencmd 

This will open the queue after a close command. 
This means that more entries may be queued. 
This command is valid on this list of devices: 
Queue. 

Requires write privilege to the device, and if 
the calling process is not the owner of the 
device, also requires operator privilege. 

parml - Not used. 

parm2 - Not used. 

parm3 - Not used. 

parm4 - Not used. 

Get entry information by entry number 

(21) quegetentrycmd 

This will receive all of the information about 
a given entry in the queue. It will access 
that entry by entry number. This command is 
valid on this list of devices: Queue. 

Requires read privilege to the device, 
parml - Entry number of which entry to get. 
parm2 - Address of buffer to receive the queue 

create process buffer. 
parm3 - Address of buffer to receive the queue 

entry buffer. 
parm4 - Address of a longword to receive this 

entry's entry number. 
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Get default create process record 
(22) quegetdefcrpcmd 



This will get the default create process record. 
This record is used when a user redirects output 
directly to the queue device. This command is 
valid on this list of devices: Queue. 

Requires read privilege to the device, 
parml - Address of buffer to receive the 

default queue create process record. 
parm2 - Not used. 
parm3 - Not used. 
parm4 - Not used. 

Set default create process record 
(23) quesetdefcrpcmd 

This will set the default create process record. 
This record is used when a user redirects output 
directly to the queue device. This command is 
valid on this list of devices: Queue. 

Requires write privilege to the device, and if 
the calling process is not the owner of the 
device, also requires operator privilege. 

parml - Address of the new default queue 
create process buffer. 

parm2 - Not used. 

parm3 - Not used. 

parm4 - Not used. 

timout - Maximum amount of time to wait for the operation 
to complete. Expressed in 100'ths of a second 

parml - A parameter defined by the function 

parm2 - A parameter defined by the function 

parm3 - A parameter defined by the function 

parm4 - A parameter defined by the function 

status - Address of a long word to receive the result of 
the operation. 



Diagnostics: 

errinsufpriv 
errtimeout 
errinvdevnam 
errundevnam 



(1) The process lacks the privileges required to 

perform the operation. 
(128) A request was not completed within the 
specified time. 

(130) The specified devicename is syntactically 
incorrect. 

(131) The MCS does not recognize the devicename. 
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errinvcloper (173) 

errprevinit (188) 

errinvskpcmd (206) 

errinvdrvnum (311) 



Is the device mounted? 

The operation is inappropriate for the 

device class. 

The specified device is already mounted, 

and has another name. 

The specified skip or erase tape-function is 

undefined. 

A value in at least one field of the devicename 

is disallowed. 

Device errors 



See Also: 



_dismnt - 
_getdnam- 
_getdst - 
_giodst - 
_mount - 
_physio - 
_setdst - 
_siodst - 
__skip 



Dismount a logical device 

Get device name 

Get device status 

Get device status with lun 

Mount a logical device 

Perform physical I/O operation 

Set device status 

Set device status with lun 

Position tape 



Assembler Calling Sequence: 

% % sys $disk/sysincl . sys/sysequ . asm 

push dname 

push func 

push timout 

push parml 

push parm2 

push parm3 

push parm4 

push status 

jsr _physop 

C function declaration: 



; address - device name 

; value - which function 

; value - time out 

; address/ value - 1st parameter 

; address/ value - 2nd parameter 

; address/ value - 3rd parameter 

; address/ value - 4th parameter 

; address - result of the operation 

;perform physical device operation 



# include " sys $disk/sysincl. sys/sysequ. h" 

/* perform physical device operation */ 
long /* returns result of the operation */ 

_phy sop (dname. func, timout, parml, parm2, parm3, parm4) 
char dname [94]; /* device name */ 



long func; 


/* 


which function * y 


long timout; 


/* 


time out */ 


long parml; 


/* 


1st parameter */ 


long parm2; 


/* 


2nd parameter */ 


long parm3; 


/* 


3rd parameter */ 


long parm4; 


/* 


4th parameter */ 



Fortran Subroutine Declaration: 
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! perf onn physical device operation 
subroutine physop (dname, func, timout, parml, parm2, 
parm3, parm4, status^ 



character*94 dname 
integer* 4 func 
integer*4 timout 
integer* 4 parml 
integer*4 parm2 
integer*4 parm3 
integer* 4 parm4 
integer*4 status 

Pascal Procedure Declaration: 



device name 

which function 

time out 

1st parameter 

2nd parameter 

3rd parameter 

4th parameter 

result of the operation 



Note that all of the parm components are defined as long integers. 
Where the address of a variable is to be passed, use the following 
function. _physop ( . . . f cast (vice (variable) , longint) , . . . ) 



% %sys $disk/sysincl . sys/sysequ . pas 
procedure physop ( 



dname 
func 
timout 
parml 
parm2 
parm3 
parm4 
var status 
external ; 



string [93] 

longint; 

longint; 

longint; 

longint; 

longint; 

longint; 

longint 



{** perform physical device operation} 
{** device name} 
{** which function} 
{** timeout value} 
{** 1st parameter} 

2nd parameter} 

3rd parameter} 

4th parameter} 

result of the operation} 



;** 
;** 

{** 
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Return a list of all known process ID numbers on the system. 

Description: 

Return a list of process ID numbers for all processes running on the 
system. 

Related Privileges: 

None. 
Parameters: 

siteid 

pidlst 

len 

retlen 

total 



status 



- The site ID for which the list of process IDs is 
being requested. 

- Address of buffer to receive the process IDs known 
about in the system. This buffer must be word aligned. 

- Maximum number of process IDs that can be contained in 
the pidlst buffer. 

- Address of a long word to receive the number 
of process IDs that were written into pidlst. 

- Address of a long word to receive the total number of 
processes running on the system. Ihis number may be 
greater than the number returned in retlen. 

- Address of a long word to receive the result of the 
operation. 



Diagnostics: 

erroddbufaddr (3) 

errinvsiteid ( 8) 
See Also: 

_prclst - Get process IDs on a priority level. 



The process's buffer does not begin on a word 

boundary. 

The specified site ID does not exist. 
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Assembler Calling Sequence: 



push 


siteid 


push 


pidlst 


push 


len 


push 


retlen 


push 


total 


push 


status 


jsr 


.pidlst 



C Function Declaration: 



long 

_pidlst(siteid f pidlst, len, 

long siteid; 

long *pidlst; 

long len; 

long *retlen; 

long *total; 

FORTRAN Subroutine Declaration: 



; value - system id 

; address - process id buffer 

;value - length of pidlst 

; address - number of PIDs returned 

; address - total number of processes 

;address - result of the operation 

;get list of process ids 



/* get list of process ids */ 
/* returns result of the operation */ 
retlen, total, status) 
/* system id */ 
/* PID buffer */ 
/* length of pidlst */ 
/* number of PIDs returned */ 
/* total number of process ids */ 



! get list of process ids 
subroutine _pidlst (siteid, pidlst, len, retlen, total, 
status) 



integer*4 siteid 
integer *4 pidlst 
integer *4 len 
integer*4 retlen 
integer *4 total 
integer *4 status 



i system id 

1 PID buffer 

1 length of pidlst 

I number of PIDs returned 

! total number of process ids 

1 result of the operation 



Pascal Procedure Declaration: 



procedure _pidlst( 
siteid 
pidlst 
len 
var retlen 
var total 
var status 
) ; external; 



{** get list of process ids 
longint; {** system id} 
*array_of_char; {** PID buffer} 
longint; {** length of pidlst} 
longint; {** number of PIDs returned} 
longint {** total number of process ids} 
longint (** result of the operation} 
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Get PIDs on a priority level. 

Description: 

Given a priority level this call returns a list of process 
ids (pids) of the processes assigned to that priority. 

Related Privileges: 

None. 



Parameters: 
siteid 

priort 

pidlst 

len 
retlen 

status 



- A long word containing the system id of the system 
whose process list is being requested. A siteid of 
zero corresponds to the system on which the calling 
process is executing. 

- Desired priority level. If it is not in the 
range of valid priorities (0..3) it is used 
modulo 4. 

- Address of buffer to receive the process id's of 
processes at the above priority level. This buffer 
must be word aligned. 

- Maximum number of process id's that can be 
contained in the pidlst buffer 

- Address of a long word to receive the number 
of pid's that were written into pidlst. If an 
error is encountered, the retlen will be set to 0. 

- Address of a long word to receive the result of 
the operation. 



Diagnostics : 

erroddbufaddr 

errinvsiteid 
See Also: 



(3) The process's buffer does not begin on a word 

boundary. 
(8) The specified site id does not exist. 



gengy - Get pid of ancestor process 

getpid - Get process id (pid) from name 
"getpnam- Get process name from pid 



Assembler Calling Sequence: 



push 


siteid 


push 


priort 


push 


pidlst 


push 


len 



;value - system id 

;value- - priority level 

;address - pid buffer 

;value - length of pidlst 
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push 


retlen 


push 
jsr 


status 
prclst 



jaddress - number of pid's returned 

jaddress - result of the operation 
;get pids on a priority level 



C function declaration: 



/* get pids on a priority level */ 

long /* returns result of the operation */ 

__prclst(siteid, priort , pidlst, len, retlen) 

long siteid; /* system id */ 

long priort; /* priority level */ 

long *pidlst; /* pid buffer */ 

long len; /* length of pidlst */ 

long *retlen; /* number of pids returned */ 

Fortran Subroutine Declaration: 

c ! get pids on a priority level 

subroutine prclst(siteid, priort, pidlst, len, retlen, status) 



integer*4 siteid 

integer*4 priort 

integer*4 pidlst 

integer*4 len 

integer*4 retlen 

integer*4 status 

Pascal Procedure Declaration: 



system id 
priority level 
pid buffer 
length of pidlst 
number of pids returned 
result of the operation 



procedure _prclst( 
siteid 
priort 
pidlst 
len 
var retlen 
var status 
) ; external; 



{** get pids on a priority level} 

longint; {** system id} 

longint; {** priority level} 

A array__of_char ; {** pid buffer} 

longint; {** length of pidlst} 

longint; {** number of pid's returned} 

longint {** result of the operation} 
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_PRIRAT 

Set priority scheduling ratio. 

Description: 

This system call allows the process with operator privilege to set 
the priority level refresh counts for the scheduler. By default the 
refresh counts are set to 10. 



For each process executing at priority 1, ratio [1 
execute at priority 0. 

For each process executing at priority 2, ratio [2 
execute at priority 1. 

For each process executing at priority 3, ratio [3 
execute at priority 2. 

For each process executing at priority 4, ratio [4 
execute at priority 3. 

For each process executing at priority 5, ratio [5 
execute at priority 4. 

For each process executing at priority 6, ratio [6 
execute at priority 5. 

For each process executing at priority 7, ratio [7 
execute at priority 6. 

For each process executing at priority 8, ratio [8 
execute at priority 7. 

For each process executing at priority 9, ratio [9 
execute at priority 8. 

For each process executing at priority 10, ratio [10] processes will 
execute at priority 9. 

For each process executing at priority 11, ratio [11] processes will 
execute at priority 10. 

For each process executing at priority 12, ratio [12] processes will 
execute at priority 11. 



processes will 
processes will 
processes will 
processes will 
processes will 
processes will 
processes will 
processes will 
processes will 
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For each process executing at priority 13, ratio [13] processes will 
execute at priority 12. 

For each process executing at priority 14 , ratio [14] processes will 
execute at priority 13. 

For each process executing at priority 15, ratio [15] processes will 
execute at priority 14. 

Related Privileges: 

- Process not allowed to set scheduling ratio 



none 
operator 

Parameters: 

siteid 



ratio 



status 



Diagnostics : 



- Allows process to set scheduling ratio 



A long word containing the system id of the system 

whose priority ratio is to be set. A siteid of zero 

corresponds to the system on which the calling process 

is executing. 

Mdress of an array of 15 integers (16 bit words) 

containing the scheduling ratios for each priority level. 

This array must be word aligned. Each of the 15 integers 

may contain a value between 1 and 32767. Negative values 

are prohibited. 

Address of a long word to receive the result of 

the operation. 



errinsufpriv (1) 



errinvsiteid 
errpriorratio 



(8) 
(58) 



•Hie process lacks the privileges required to 

perform the operation. 

The specified site id does not exist. 

The priority ratio for the scheduler is less 

than or equal to zero. 



See Also: 



_setpri - Change process's priority 
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Assembler Calling Sequence: 



push 


siteid 


push 


ratio 


push 


status 


jsr 


_prirat 



C Function Declaration: 



long 

_prirat (siteid, ratio) 

long siteid; 

int ratio [15] ; 

FORTRAN Subroutine Declaration: 



;value - system id 

; address - array of ratios 

; address - result of the operation 

;set priority scheduling ratio 



/* set priority scheduling ratio */ 
/* returns result of the operation */ 

/* system id */ 
/* array of ratios 



! set priority scheduling ratio 
subroutine _prirat (siteid, ratio, status) 
integer*4 siteid ! system id 
integer*2(15) ratio ! array of ratios 
integer*4 status 1 result of the operation 



Pascal Procedure Declaration: 

procedure _prirat( 

siteid : longint; 
ratio : array [1.. 15] 
var status : longint 

) ; external ; 



{** set priority scheduling ratio) 
{** system id) 
of integer; {** array of ratios) 
{** result of the operation) 
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_PROTMEM 
Change memory page protection. 

Description: 

Modify the write protection on a specified page of 
logical memory owned by the current process. 

Related Privileges: 

none - Allows modification of memory protection on 

any owned page of memory assigned to the calling 
process. Note that shareable pages are not 
owned by any process. 

writephys - Allows modification of memory protection on 
any page of memory assigned to the calling 
process. 
Parameters : 

adr - Address of the page of logical memory which is 

to be protected or unprotected. This address must 
be on a 4K byte boundary. 

prot - protection. indicates that the page is not to be 
write protected. 1 indicates that the page is 
to be write protected. Other values are reserved 
and should not be used. 

status - Address of a long word to receive the result of 
the operation. 

Diagnostics: 

errinsufpriv (1) The process lacks the privileges required to 

perform the operation, 
errinvadr (4) The logical address, for the memory requested, 

is invalid, 
errnonowned (6) The process tried to affect a page in memory it 

did not own. 

See Also: 



__allmem - Allocate dynamic memory 
fremem - Deallocate a page of memory 

Assembler Calling Sequence: 



push 


adr 


push 


prot 


push 


status 


jsr 


protmem 



;value - address of memory page 
;value - protection value 
jaddress - result of the operation 
;change memory page protection 
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C function declaration: 



long 

__protmem(adr , prot) 

long adr; 

long prot; 

Fortran Subroutine Declaration 



/* change memory page protection */ 
/* returns result of the operation */ 

/* address of memory page */ 
/* protection value */ 



! change memory page protection 
subroutine protme(adr, prot, status) 

integer*A adr ! address of memory page 
integer*A prot ! protection value 
integer*4 status ! result of the operation 



Pascal Procedure Declaration: 

procedure _protmem( 

adr : longint; 
prot : longint; 
var status : longint 

) ; external; 



{** change memory page protection} 

{** address of memory page} 

{** protection value} 

{** result of the operation} 
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Read physical memory. 
Description: 

By default a process can access any memory that is 
part of its own logical address space ($000000 through 
$1FFFFF) To access memory above two megabytes, the 
process must either change to supervisor mode of 
operation or use this call asking MCS to read the 
memory for it. 

Using __rdpmem to read physical memory has the additional 
property that when memory errors (e.g. attempt to 
access non-existant memory) occur, they are reported 
to the process through the status variable and are 
not considered fatal errors. 

A process must have readphys privilege to read addresses 
in physical memory. 

Related Privileges: 

none - Process not allowed to read physical memory 
readphys - Allows process to read physical memory 

Parameters: 



siteid 



adr 
mode 



buf 

nrec 
trnsf r 
status 



- A long word containing the system id of the 

system whose physical memory is to be read. 
A siteid of zero corresponds to the system on 
which the calling process is executing. 

- Address in physical memory to be read. 

- Specifies whether to use byte, word or 

long word transfers from the specified address. 
indicates byte, 1 indicates word and 2 
indicates long word transfers. All other 
values are reserved and should not be used. 

- Address of the buffer to receive the data 
read from the specified address. 

- The number of units (bytes, words or long words) 
to be transferred. 

- Address of a long word to receive the number of 
units actually transferred. 

- Address of a long word to receive the result of 
the operation. 



Diagnostics: 

errinsufpriv (1) The process lacks the privileges required to 
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erroddbufaddr (3) 

errbustrap (37) 

errnonexmem (39) 

errmeraparity (40) 



perform the operation. 

The process's buffer does not begin on a word 

boundary. 

The process has a bus error. 

The process attempted to access nonexistent memory. 

The process has a memory parity-error. 



See Also: 



push 


siteid 


push 


adr 


push 


mode 


push 


buf 


push 


nrec 


push 


trnsfr 


push 


status 


jsr 


rdpmem 



__chsuper - Change to supervisor mode 
__wtpmem - Write physical memory 

Assembler Calling Sequence: 

;value - system id 

;value - address to be read 

;value - byte, word, long word moves 

;address - user buffer 

; value - number of units to read 

;address - num of units transferred 

jaddress - result of the operation 

;read physical memory 

C function declaration: 

/* read physical memory */ 
long /* returns result of the operation */ 

_rdpmera( siteid, adr, mode, buf, nrec, trnsfr) 

long siteid; /* system id */ 

long adr; /* address to be read */ 

long mode; /* byte, word, long word moves */ 

char *buf; /* user buffer */ 

long nrec; /* number of units to read */ 

long *trnsfr; /* num of units transferred */ 

Fortran Subroutine Declaration: 

c ! read physical memory 

subroutine rdpmem( siteid, adr, mode, buf, nrec, trnsfr, status) 



integer*4 siteid 
integer*4 adr 
integer*4 mode 
character*(*) buf 
integer*4 nrec 
integer*4 trnsfr 
integer*4 status 

Pascal Procedure Declaration: 



! system id 

! address to be read 

! byte, word, long word moves 

! user buffer 

! number of units to read 

! num of units transferred 

! result of the operation 



procedure _rdpmem( 

siteid : longint; 



{** read physical memory} 
{** system id} 
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adr : longint; {** address to be read} 

mode : longint; {** byte, word, long word moves} 

buf : ~array__of__char ; {** user buffer} 

nrec : longint; {** number of units to read} 

var trnsfr : longint; {** num of units transferred} 

var status : longint {** result of the operation} 
); external; 
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read 



read - Read from an open file. 

Description: 

Given a valid logical unit number (lun) of a file 
open for read access, transfers one or more records 
from the file to the process's buffer. 

On successful completion- returns the number of complete 
records actually transferred. This number may be less 
than the number requested if: 

1) logical end of file was reached. 

2) a timeout occurs. 

3) a device error occurs. 

4) the end of a line was reached while reading 
with edit mode 2 

Related Privileges: 

None , 

Parameters : 

lun - logical unit number (lun) of the file to be read. 

recnum - The record number to be read. means the 

first record in a file. A recnum of $FFFFFFFF (-1) 
represents the next sequential record. Note that 
recnum is an unsigned long word. 

edmode - The edit mode to use. This parameter is divided 

into two 16 bit fields. The least significant word 
represents which edit mode processor to use. The 
most significant word contains edit mode flags for 
the processor. 

An input edit mode processor is used to filter the 

input stream before it is passed to the process. The 

the following transformations are defined: 

Name Edmode Description 

emvreadraw Raw data. No alterations of data. 
1 Reserved. 

emvreadln 2 For tty class devices , read line. 

Returns to the user process all 
characters from the specified position 
up to and including the line terminator. 
For tty, pipe, sync and nondev class 
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emvreadlnwchr 



devices, all carriage returns (13) are 
converted to line feeds (10) . For 
other device classes the line 
terminator is unmodified. 

Control does not return to the calling 
process until a line terminator is 
entered or a timeout occurs. Valid 
line terminators are line feed (10) , 
vertical tab (11) , form feed (12) , 
or carriage return (13) . Processing 
delete characters (127) (prints a 
backspace, space, backspace and removes 
the last character from the buffer) is 
handled automatically. 

If the length of the line actually 
read exceeds the nrecs parameter, 
(the number of characters to be read) , 
then nrecs number of characters are 
returned and the status parameter 
returns a warning. 

If the record length on the file 

being read is not one (1) , an error 

is returned, and no data is transferred. 

For other classes (disk, diskspc, tape, 
tapespc, pipe, pipespc, sync, 
syncspc, network, networkspc, ttyspc, 
tape$l, tape$lspc) this edit mode is 
undefined and functions the same as 
edit mode 0. 

For tty class devices, read character. 
Returns to the user process one or 
more bytes from the specified position. 
All line terminators are mapped to a 
line feed (10) . 

Control does not return to the calling 
process until a line terminator is 
entered or a timeout occurs. Valid 
line terminators are line feed (10) , 
vertical tab (11) , form feed (12) , 
or carriage return (13) . Processing 
delete characters (127) (prints a 
backspace, space, backspace and removes 
the last character from the buffer) is 
handled automatically. When the line 
terminator is entered, the first 
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character on the line is returned to 
the user process. Subsequent calls 
using edit mode 3 get subsequent 
characters on the line up to and 
including the mapped line terminator. 
The nrecs parameter specifies how many 
characters are to be returned. 

If the record length on the file 

being read is not one (1) , an error 

is returned , and no data is transferred. 

For other classes (pipe/ pipespc, sync, 
syncspc, network, networkspc, ttyspc, 
tape, tapespc, disk, diskspc, tape$l, 
tapeSlspc) this edit mode is undefined 
and functions the same as edit mode 0. 
emvreadlnall 4 Pead line. Returns to the user 

process all characters from the 
specified position up to and including 
the line terminator. For tty, pipe, 
sync and nondev class devices, all 
carriage returns (13) are transformed 
to line feeds (10) . For other 
device classes the line terminator is 
unmodified. 

For tty class devices, this edit 
mode works the same as edit mode 2. 
Control does not return to the calling 
process until a line terminator is 
entered or a timeout occurs. Valid 
line terminators are line feed (10) , 
vertical tab (11) , form feed (12) , 
or carriage return (13) . Processing 
delete characters (127) (prints a 
backspace, space, backspace and removes 
the last character from the buffer) is 
handled automatically. 

For disk, tape and pipe class devices, 
the line terminator is a line feed (10) . 

If the length of the line actually 
read exceeds the nrecs parameter, 
(the number of characters to be read) , 
then nrecs number of characters are 
returned and the status parameter 
returns a warning. 

If the record length on the file 
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being read is not one (1) , an error 

is returned, and no data is transferred. 

For other classes (diskspc, 
tapespc, pipespc, sync, syncspc, 
network, networkspc, ttyspc, 
tape$l, tape$lspc) this edit mode is 
undefined and functions the same as 
edit mode 0. 

Read character. Returns to the user 
process one or more bytes from the 
specified position. All line 
terminators are mapped to a 
line feed (10) . 

For tty class devices this edit mode 
is the same as edit mode 3. 
Control does not return to the calling 
process until a line terminator is 
entered or a timeout occurs. Valid 
line terminators are line feed (10) , 
vertical tab (11) , form feed (12) , 
or carriage return (13) . Processing 
delete characters (127) (prints a 
backspace, space, backspace and removes 
the last character from the buffer) is 
handled automatically. 

For pipe, disk and tape class devices, 
the line terminator is line feed (10) . 
The specified number of characters 
(up to the line terminator) are returned 
to the user process. 

When the line terminator is entered, 
or encountered, the first character 
on the line is returned to the user 
process. Subsequent calls using 
edit mode 5 get subsequent characters 
on the line up to and including the 
mapped line terminator. The nrecs 
parameter specifies how many 
characters are to be returned. 

If the record length on the file 

being read is not one (1) , an error 

is returned, and no data is transferred. 

For other classes (pipespc, sync, 
syncspc, network, networkspc, ttyspc, 
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tapespc, diskspc, tape$l, 

tape$lspc) this edit mode is undefined 

and functions the same as edit mode 0. 



The most significant word of the edmode parameter 
contains the following bit flags. If the bit is a 
one (1) the mode is as described here. 



Bit Name Bit 
emnoecho 16 



emspcompact 17 



emnofastread 18 



emnoverifyrd 19 



emlockunlock 



20 
21 



22-31 



Description 

No echo - As characters come 

in on tty class devices, they are 

not echoed back. 

Space decompaction - On sync class 

devices compacted spaces are 

automatically expanded. 

No fast read - On disk class devices, 

this bit allows a process to do a 

'normal 1 read on a file which was 

opened for fast reads. 

No verify read ok - Will return input 

data on sync class reads when input 

buffer becomes more than half full 

even though the data has not been 

verified. If the data turns out to 

be bad, an error is returned on the 

subsequent read. 

Reserved. Must be set to zero 

Read and lock - On disk class devices, 

this bit will cause all of the records 

requested to be read be locked. 

Reserved. Must be set to zero (0) . 



timout - The wait count is in 100'ths of a second and represents 
the amount of time to wait for the .read to complete 
before returning to the user process. If a timeout 
occurs, the data received up to that point will be 
returned to the process. 

buf - Address of the process's buffer into which the data 
will be read. May be on a word or a byte boundary 
unless the file was open for fast read in which case 
it must be on a word boundary. Also, if the file 
is to be read with a fast read, the entire buffer 
must exist on the same four kilobyte page of memory. 

nrecs - Number of records to read. This parameter is an 
unsigned long word. If it is zero, no data is 
transferred. 

trnsfr - Address of a long word to receive the number of 
records actually read. 

status - Address of a long word to receive the result of 
the operation- 
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Diagnostics : 

errtimeout (128) 

errinvlfn (132) 

errreqtolrg (137) 

errreadleof (140) 

errnoreadacc (141) 

errinvreadreq (165) 

errpagebndry (166) 

errinveditmd (189) 

errbadpos (197) 

errdeadlock (234) 

errreclocked (235) 

errlockint (254) 



A request was not completed within the 

specified time. 

The logical unit number does not correspond to 

an open file. 

The request is too large for the system to handle. 

The process tried to read past the logical end 

of a file. 

The process does not have read-access to the file. 

The read request is invalid. 

The request crosses a physical page boundary 

in memory. 

The MCS does not recognize the specified edit mode. 

The process tried to access a record (on a tape) 

out of sequence. 

The specified record cannot be locked without 

causing a deadlock. 

The specified record (s) are locked by another 

process. 

(MCS error) A discrepency in the Record Locking 

code has been detected. 

Device integrity errors 



See Also: 



_bscbid - 
_bscpol ■ 
_create - 
_frdwait- 
_getpos • 
_J.ock 
_open 
_setpos - 
_unlock ■ 
__write - 



Bid or wait for bid 

Multipoint bisync line control 

Create a file 

Wait for fast read to complete 

Get the current file position 

Lock records within an open file 

Open a file 

Set the current file position 

Unlock records within an open file 

Write to an open file 



Assembler Calling Sequence: 



push 
push 
push 
push 
push 
push 
push 
push 
jsr 



lun 

recnum 

edmode 

timout 

buf 

nrecs 

trnsfr 

status 

_read 



; value - logical unit number 

; value - record number 

; value - edit mode 

; value - time out 

•address - user buffer 

;value - number of records to read 

; address - number actually read 

;address - result of the operation 

;read from an open file 



C function declaration: 



READ-6 



Dictionary of WMCS System Calls 

read 



/* read from an open file */ 
long /* returns result of the operation */ 

_read (lun , recnum, edmode , timout ,buf , nrecs , trnsf r ) 

long lun; /* logical unit number */ 

record number */ 
edit mode */ 
time out */ 
user buffer */ 

number of records to read */ 
number actually read */ 



long recnum; 
long edmode; 
long timout; 
char *buf ; 
long nrecs; 
long *trnsfr; 



/* 
/* 
/* 
/* 

/* 
/* 



Fortran Subroutine Declaration: 



! read from an open file 
subroutine read (lun, recnum, edmode, timout, buf, 
trnsf r. status) 



edmode 
timout 



St nrecs 

integer*4 lun 
integer* 4 recnum 
integer* 4 
integer*4 
character*!*) buf 
integer*4 nrecs 
integer *4 trnsf r 
integer* 4 status 

Pascal Procedure Declaration: 



procedure read ( 
lun 

recnum 
edmode 
timout 
buf 
nrecs 
var trnsfr 
var status 

) ; external ; 



I logical unit number 

! record number 

! edit mode 

I time out 

i user buffer 

I number of records to read 

! number actually read 

! result of the operation 



{** read from an open file} 

longint; {** logical unit number} 

longint; {** record number} 

longint; {** edit mode} 

longint; {** time out value} 

"array of_char; {** user buffer} 

longint; {** number of records to read} 

longint; {** number of records read} 

longint {** result of the operation} 
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Rename a file. 

Description: 

Given a file name, locates the file and give it a new 
name. Both file names are logically translated before 
being used. Can be used to rename a file into another 
directory. Files cannot be renamed to other devices. 

The new file is identical to the old file in every 
way (owner, protection, record length, etc) except for 
the new name. 

A directory file on disk devices can be renamed to any place 
in the directory hierarchy except as a subdirectory of itself. 

Unless the process has bypass privilege, it must have read 
and write privilege to the device containing the file, execute 
privilege to all directories in both the original and new 
paths leading to the file, read and write privilege to the 
directory containing the file, read and write privilege to 
the new directory to contain the file and read and write 
privilege to the file itself in order for the file to be 
successfully renamed. 

If the original file name is specified by fcb.seq number 

the process must have read and write privilege to the 

device containing the file, execute privilege 

to all directories in the new path leading to the file, 

read and write privilege to the both the directory containing 

the file and the new directory to contain the file and read 

and write privilege to the file itself. 

Related Privileges: 

None - Allows renaming if process has access to the 

file as described above, 
altuic - Allows renaming if the owner of image file 

for the current process has access to the file 

as described above, 
bypass - Allows the process to rename the file independent 

of the file protection, 
system - Allows renaming if the system has access to 

the file as described above. 

Parameters : 

fname - Address of null terminate- J string containing 

the file name of an existing file to be renamed. 
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This string will be translated automatically by 
the MCS to its logical equivalent. This string 
may contain up to 93 valid characters followed 
by a null. 

newnam - Address of null terminated string containing 
the new file name to be given to the file. 
This string will be translated automatically by 
the MCS to its logical equivalent. This string 
may contain up to 93 valid characters followed 
by a null. 

status - Address of a long word to receive the result of 
the operation. 



Diagnostics: 



errnomemavail 


(7) 


errinwernum 


[129) 


errinvdevnam 


(130) 


errundevnam 


(131) 


errfilnotfnd ( 


:i33) 


errfilexists ( 


:i34) 


errnoexecpriv ( 


143) 


errnoreadpriv ( 


144) 


errnowritepriv ( 


145) 


errinvfnstr ( 


:i47) 


errinvdirfle ( 


U48) 


errinvdirstr ( 


:i49) 


errrendif fdev ( 


:i67) 


errinvcloper 


(173) 


errdirnotfnd < 


(177) 


errinvdirren ( 


(186) 



All available memory has been allocated. 

A file's version number cannot be greater 
than 65535. 

The specified devicename is syntactically 

incorrect. 

The MCS does not recognize the devicename. 

Is the device mounted? 

The specified file could not be found. 

The specified version of the file already exist? 

The process does not have Execute Privilege for 

the file. 

The process does not have Read Privilege for 

the file. 

The process does not have Write Privilege for 

the file. 

The specified filename is syntactically incorrect 

The specified directory is not a directory. 

The specified directory name is syntactically 

incorrect . 

A file cannot be renamed to another device. 

The device class is inappropriate for the 

operation. 

The specified directory does not exist. 

The process tried to rename a directory as 

its own subdirectory. 

Device integrity errors 



See Also: 



none. 
Assembler Calling Sequence: 



push 
push 
push 



fname 

newnam 

status 



;address - original file name 

;address - new file name 

jaddress - result of the operation 
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jsr _rename 
C function declaration: 



long 

__rename ( f name , newnam ) 

char fname [94] ; 

char newnam [94]; 

Fortran Subroutine Declaration: 



; rename a file 



/* rename a file */ 

/* returns result of the operation */ 

/* original file name */ 
/* new file name */ 



! rename a file 
subroutine rename (f name, newnam, status) 

character*94 fname ! original file name 
character*94 newnam ! new file name 
integer*4 status ! result of the operation 



Pascal Procedure Declaration: 

procedure rename ( 

fname : string[93]; 

newnam : string[93]; 
var status : longint 
) ; external; 



{** rename a file} 

{** original file name} 

{** new file name} 

{** result of the operation} 
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Return a list of all known remote network ID numbers. 

Description: 

Return a list of network ID numbers and the total number of network 
ID numbers known in the network. 

Related Privileges: 

None. 



Parameters: 
rnidlst 
len 
retlen 
total 

Diagnostics : 

None. 
See Also: 



Address of buffer to receive the remote network IDs known 

about. This buffer must be word aligned. 

Maximum number of network IDs that can be 

contained in the rnidlst buffer. 

Address of a long word to receive the number 

of network IDs that were written into rnidlst. 

Address of a long word to receive the total number of 

network IDs known about in the system. This number may be 

greater than the number returned in retlen. 



_getnnam - Get the name of a node 

_getnsid - Get the site ID of a node 

_rsidlst - Get list of site IDs from a remote network 

.jsidlst - Get list of site IDs on current network 



Assembler Calling Sequence: 



push 


rnidlst 


push 


len 


push 


retlen 


push 


total 


jsr 


_rnidlst 



; address - rnid buffer 

;value - length of rnid buffer 

; address - number of rnids returned 

; address - total number of rnids 

;get list of remote network ids 
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C Function Declaration: 



void 

_rnidlst( rnidlst, len, retlen, 

long *rnidlst; 

long len; 

long *retlen; 

long *total; 

FORTRAN Subroutine Declaration: 



/* get list of remote network ids */ 
/* no result */ 
total) 

/* rnid buffer */ 
/* length of rnidlst */ 
/* number of rnids returned */ 
/* total number of rnids */ 



I get list of remote network ids 
subroutine rnidls( rnidlst, len, retlen, total) 
integer *4 rnidlst I rnid buffer 

! length of rnidlst buffer 
I number of rnids returned 
I total number of rnids 



integer *4 len 
integer *4 retlen 
integer *4 total 



Pascal Procedure Declaration: 

procedure _rnidlst( {** get list of remote network ids) 
rnidlst : ~array_ofL_char; {** rnid buffer} 

len : longint; {** length of rnid buffer) 

var retlen : longint; {** number of rnids returned} 

var total : longint {** total number of rnids} 
) ; external ; 



RNIDLST-2 



_RSIDLST 

Return a list of all known site ID numbers for a remote network. 

Description: 

Return a list of site ID numbers and the total number of site ID 
numbers known for a given remote network. 

Related Privileges: 

None. 



Parameters: 
rnid 
sidlst 
len 
retlen 
total 



She remote network ID for which the list of site IDs is 

being requested. 

Address of buffer to receive the site IDs known 

about in the network. This buffer must be word aligned. 

Maximum number of site IDs that can be 

contained in the sidlst buffer 

Address of a long word to receive the number 

of site IDs that were written into sidlst. 

Address of a long word to receive the total number of 

site IDs known about in the system. This number may be 

greater that the number returned in retlen. 



Diagnostics : 

erroddbufaddr 

See Also: 



(3) The process's buffer does not begin on a word 
boundary. 



jgetnnam - Get the name of a node 
.getnsid - Get the site ID of a node 
.rnidlst - Get list of remote network IDs 
sidlst - Get list of site IDs from current network 
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Assembler Calling Sequence: 



push 


mid 


push 


sidlst 


push 


len 


push 


retlen 


push 


total 


jsr 


_rsidlst 



;value - remote network id 
; address - siteid buffer 
;value - length of sidlst 
; address - number of siteids returned 
; address - total number of siteidso 
;get list of site ids 



C Function Declaration: 



long 

_rsidlst(mid, sidlst, len, 

long mid; 

long *sidLst; 

long len; 

long *retlen; 

long *total; 

FORTRAN Subroutine Declaration: 



/* get site ids from remote network */ 
/* returns result of the operation */ 
retlen, total) 

/* remote network id */ 

/* siteid buffer */ 

/* length of sidlst */ 

/* number of siteids returned */ 

/* total number of site ids */ 



1 get site ids from remote network 
subroutine _rsidls(mid, sidlst, len, retlen, total) 



integer*4 rnid 
integer*4 sidlst 
integer *4 len 
integer *4 retlen 
integer *4 total 

Pascal Procedure Declaration: 



1 remote network id 

I siteid buffer 

! length of sidlst 

I number of siteids returned 

! total number of site ids 



procedure _rsidlst( 



rnid 
sidlst 
len 
var retlen 
var total 
) ; external ; 



{** get list of site ids from remote network) 



longint; {** remote network id) 
~array_of__char; {** siteid buffer) 
longint; {** length of sidlst) 
longint; {** number of siteids returned) 
longint {** total number of site ids) 
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_JSETA!TC!R 
Set PCB attribute bits. 

Description: 

Call this routine to set the process attribute bits in the PCB for a 
particular process. To modify the process attributes of a process 
use _GEEATTR first to get the current ones and set or reset the 
appropriate bits, then call this routine with the modified value. 

Related Privileges: 



none 

group 
world 
Parameters: 
pid 

attr 



- Allows affecting the attributes of any process with 
the same owner ID and group ID (UIC) as the calling 
process. 

- Allows affecting the attributes of any process with 
the same group ID as the calling process. 

- Allows affecting the attributes of any process. 



A long word containing the process ID of the process 
whose attributes are to be changed. represents 
the current process; -1 ($FFFFFFFF) represents the 
parent of the current process. 
A long word containing the new attributes to set. 

Process attribute bit definitions. Note that these 
offsets are defined for being in the high word of a 
longword. Because it is only a word in the PCB, if you 
access the PCB directly you will have to shift these 
numbers right by 16. 

If all bits are set to zero, it signifies that the 
attribute bits of the process's parent are to be used. If 
the bits are non-zero, the attributes are to be taken as 
specified, unless only the high order bit 
(pcbattrforceset) is set. If only the pcbattrforceset 
bit is set, it signifies that all other bits are intended 
to be set to zero. 
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Bit Name 



Bit Number 



pcbattrdesencrypt 16 



pcbattrfastencrypt 17 



pcbattruserl 


23 


pcbattruser2 


24 


pcbattruser3 
pcbattruser4 


25 
26 


pcbattrnowatchdog 


27 


pcbattrswappable 


28 


pcbattrpr ez eromem 


29 


pcbattrpostz eromem 


30 


pcbattrforceset 


31 



Description 



If set, do network 
encryption with DES 
algorithm. 
If set, do network 
encryption with fast 
algorithm. 
If set, user 
attribute bit 1. 
If set, user 
attribute bit 2. 
If set, user 
If set, user 
attribute bit 4. 
If set, cannot be 
watchdogged. 
If set, the OS will 
not swap this process. 
If set, pages of 
memory are zeroed as 
they are allocated. 
If set, pages of 
memory are zeroed as 
they are released. 
If set, then modify 
the bits. Must be set 
to cause other bits 
to take effect. 



status 



- Address of a long word to receive the result of 
the operation. 



Diagnostics: 

errinsufpriv 
errprcsnotfnd 

See Also: 



(1) The process lacks the privileges required to 
perform the operation. 

(2) Hie specified process is not in the system 
process table. 



_getattr - Get PCB attribute bits 
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Assembler Calling Sequence: 



push 


pid 


push 


attr 


push 


status 


jsr 


_setattr 



C Function Declaration: 



long 

_setattr (pid, attr) 

long pid; 

long attr; 

FORERAN Subroutine Declaration: 



;value - process id 
; value - new attribute bits 
;address - result of the operation 
;set the attributes 



/* change process attributes */ 

/* returns result of the operation */ 



/* process id */ 
/* new attributes */ 



subroutine _setatt(pid, 
integer *4 pid 
integer *4 attr 
integer *4 status 

Pascal Procedure Declaration: 

procedure _setattr( 

pid : longint; 
attr : longint; 
var status : longint 

) ; external ; 



1 change process attributes 
attr, status) 
I process id 
1 new attributes 
1 result of the operation 



{** change process attributes) 

{** process id) 

{** new attributes) 

{** result of the operation) 
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Set device protection. 
Description: 

Establishes the protection to be applied to a device. 
The protection grants access privileges to the device 
for classes of users. 

This operation is valid for any mounted device. 

To successfully change protection on a device the 

process must have operator privilege, bypass privilege 

or have the same owner id and group id as the device itself. 

Related Privileges: 

None - Allows the owner of a device to modify the protection, 
altuic - Allows the process to change the protection if the 

owner of the process's image file is the same as 

the owner of the device, 
bypass - Allows the process to change the protection on any 

device, 
operator - Allows the process to change the protection on any 

device. 



Parameters 
dname 



prot 



Address of a null terminated string containing the 

the name of the device whose protection is to be set. 
This string may contain up to 93 significant characters 
followed by a null. This string will be translated 
automatically by the MCS to its logical equivalent. 
If this string contains a file designation, the 
devicename portion of the file designation is used for 
this parameter. 

File protection mask. The least significant 
16 bit word of this parameter is divided into 
4 nibbles. Each nibble corresponds to a class 

of users. The bits within each nibble represent 
the type of access that class of user is granted 

for this device. If the bit is set (1) the access 
is granted. 

From the least to the most significant nibble 
the user classes are: 

Ownr - device owner 

Grp - processes with the same group id as the owner 

Pub - all other processes in the system 
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Sys - processes with SYSTEM privilege 
Sys Pub Grp Ownr 

| DWRE | DWRE | DWRE | DWRE | 
, , 

MSB LSB 

From the least to the most significant bits within 
the nibbles, the access privileges are: 

E - Execute access 

R - Read access 

W - Write access 

D - Delete access 

A long word -1 ($FFFFFFFF) is a reserved value that 

means that the user's default protection mask is to be used. 

status - Address of a long word to receive the result of 
the operation. 

Diagnostics : 

errinsufpriv 

errinvdevnam 

errundevnam 



(1) The process lacks the privileges required to 
perform the operation. 

(130) The specified devicename is syntactically 
incorrect. 

(131) The MCS does not recognize the devicename. 
Is the device mounted? 



Device integrity errors 
See Also: 

_defprot - Set default protection mask 

getdprt - Get device protection 
_getfprt - Get file protection 
setfprt - Set file protection 



Assembler Calling Sequence: 
dname 



push 

push 
push 
jsr 



prot 
status 
setdprt 



C function declaration: 



long 



jaddress - device name 

jvalue - protection mask 

jaddress - result of the operation 

;set device protection 



/* set device protection */ 

/* returns result of the operation */ 
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_setdprt( dname, prot) 

char dname [ 94 ] ; 
long prot; 

Fortran Subroutine Declaration: 



/* device name */ 

/* protection mask */ 



! set device protection 
subroutine setdpr(dname, prot, status) 
character*94 dname ! device name 
integer*4 prot ! protection mask 
integer*4 status ! result of the operation 



Pascal Procedure Declaration: 

procedure __setdprt( 

dname : string[93]; 

prot : longint; 
var status : longint 
) ; external ; 



{** set device protection} 

{** device name} 

{** protection mask} 

{** result of the operation} 
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Set device status. 



Description: 



Allows a process to modify a device status table. 

The device status is a device class dependent 128 byte table, 
maintained by the device driver for each device. 



It is 



NOTE: The device status table may change with each release of 
the operating system. The current definition is included 
in each release in the file named: /SysiNCL.SYS/ 
DSTATDISP.*. The name of the record included in that file 
is "devicestatus, " i.e., in your program you can declare a 
variable whose type is "devicestatus. " 

The device status table is divided into two parts. The first half is 
device independent and is composed of the following fields: 



Name 


Length 
(bytes) 

2 


Description 






dsclassid 


The device clas 
(Note that thes 
the devtdisp.* 
Class Name V 


s. \ 
e nan 
files 
r alue 



1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

11 

12 

13 


falid classes are: 
tes are defined in 

Description 




dtclassttyspc 

dtclasstty 

dtclasstapespc 

dtclasstape 

dtclassdiskspc 

dtclassdisk 

dtclassnetspc 

dtclassnet 

dtclasspipespc 

dtclasspipe 

dtclasssyncspc 

dtclasssync 

dtclassquespc 

dtclassque 


Character device (ttyspc) 
Character device (tty) 
Tape device (tapespc) 
Tape device (tape) 
Disk device (diskspc) 
Disk device (disk) 
Network dev. (networkspc) 
Network device (network) 
Pipe device (pipespc) 
Pipe device (pipe) 
BSC device (syncspc) 
BCS device (sync) 
Queue device (quespc) 
Queue device (que) 
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dsdriverid 2 

dsblksz 2 

dsharderr 2 

dssofterr 2 

dsreadoper 4 

dswriteoper 4 

dsmaxnumdev 2 

dscurnumdev 2 

dsnumtoretry 2 

dserror reason 4 

dsreserved 32 

dsnexttableptr 4 



dtclassnondevspc 14 Non-dev device (nondevspc) 

dtclassnondev 15 Non-dev device (nondev) 

The unique ID number for this device driver 

The block size of the device (e.g. sector 

size) 

The hard error count for the device 

The soft error count for the device 

Okie number of read operations on this device 

The number of write operations on this device 

Maximum # of devices this driver can handle 

# of mounted devices using this driver 

# of times to retry before reporting an error 
Hardware error code for last error received 
on this device 

Reserved 

Address of next device status table 



The second half of the device status table is device class dependent. 
For TAPE class devices the second half is defined as follows: 





Length 










Name 


(bytes) 
2 


Description 








dstpstatus 


Tape device status. 


A bit encoded word. 






Bit name 


bit 


# 


Description 






dstpready 







Set if device ready 






dstpintpend 


1 




Set if interrupt 
pending 






dstprewinding 


2 




Set if tape rewinding 






dstpbotdetect 


3 




Set if device is at 
physical BOT 






dstpeotdetect 


4 




Set if device is at 
physical BOT 






dstpwriteprot 


5 




Set if tape is write 
protected 


dstpflagsl 


2 


Tape status inf ormation 


l. A bit encoded word. 






Bit name 


bit 


# 


Description 






dstpdoraw 







0=Read after write 

disabled 

l=Read after write 

enabled 






dstperrintenb 


1 




0=Error interrupts are 

enabled 

l=Error interrupts are 

disabled 
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dstpspeed 



dstpdensity 



dstpiopbcnt 2 

dstpcachesz 2 

dstpreserved 46 

dstpuserfield 8 
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Tape speed. Values are: 



Reserved 
12 ips 
ips 




dstpspeedl2ips 1 
dstpspeed25ips 2-25 
dstpspeed30ips 3-30 ips 
dstpspeed50ips 4-50 ips 
dstpspeed90ips 5-90 ips 
dstpspeedlOOips 6 - 100 ips 
dstpspeedl25ips 7 - 125 ips 
Tape density. Values are: 



- Reserved 

1 - 800 bpi 

2 - 1600 bpi 

3 - 3200 bpi 

4 - 6250 bpi 

5 - 6400 bpi 
Number of IOEBs allocated to device 

Number of cache elements allocated to device 

Reserved 

User defined status 



dstpdens800bpi 
dstpdensl600bpi 
dstpdens3200bpi 
dstpdens6250bpi 
dstpdens6 40 Obpi 



For DISK class devices the second half of the device status table is 
defined as follows: 



Name 



dsdkintfac 

dsdkiopbcnt 

dsdknumbsect 

dsdksectrack 

dsdkheads 

dsdkcylinders 

dsdkflagsl 



Length 

(bytes) Description 



Disk interleave factor 

Number of IOEB's allocated to the drive 

The number of sectors on the volume 

The number of sectors on a track 

The number of heads on the device 

The number of cylinders on the volume 

Disk status information. A bit encoded word. 

Bit Name Bit # Description 



dsdkdensityl 
dsdkdensity2 1 
dsdkdenssignl e 
dsdkdensdoubl e 
dsdkdensquad 
dsdkdensreserve 
dsdkdoraw 

dsdkwriteprot 



Device density 

00 - Single density 

01 - Double density 

10 - Quad density 

11 - Reserved 

If set, do Read after 

write verify 

If set, Device write 

protected 
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dsdkseekdir 15 


Current seek direction 




dsdkseekincr 


- Increasing 
cylinder numbers 




dsdkseekdecr 


1 - Decreasing 
cylinder numbers 


dsdkcurcyl 2 


Current cylinder position 


dsdkcachesz 2 


Number of sectors in the disk cache 


dsdkentryname 16 


Null terminated string containing the name of 




this type of drive 




dsdkreserved 20 


Reserved 




dsdkuserfield 8 


User Defined status 




For TH class devices 


the second half of the device status table is 


defined as follows: 






Length 






Name (bytes) 


Description 




dstymoderegl 1 


Uart mode register 1. 
encoded as follows: 


This byte is bit 




Bit Name Bit # 


Description 




dstymrlbaudfacl 


Baud factor 




dstymrlbaudfac2 1 






dstymrlsyncl 


00 - sync 1 x clock 
rate 




dstymrlasyncl 


01 - async 1 x clock 
rate 




dstymrl asyncl6 


10 - async 16 x clock 
rate 




dstymrlasync64 


11 - async 64 x clock 
rate 




dstymrl charlenl 2 


Character length 




dstymrlcharlen2 3 


definition 




dstymrl6V5bit 


00-5 data bits 




dstymrldw6bit 


01-6 data bits 




dstymrldw7bit 


10-7 data bits 




dstymrldw8bit 


11-8 data bits 




dstymrlparityctrl 4 


Parity control 




dstymrlpardis 


- disable parity 




dstymrlparenb 


1 - enable parity 




dstymrlparitytype 5 


Parity type 




dstymrlparodd 


- odd parity 




dstymrlparevn 


1 - even parity 




dstymrlstopbitsl 6 


Async mode # of stop 
bits 
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dstymodereg2 



dstyandreg 



dstymrlstopbits2 7 

dstymrlbinv 
dstymrlsbl 
dstymrlsbl5 
dstymrlsb2 
dstymrltransctrl 6 
dstymrlnormal 
dstymrl trans 
dstymrlnumsync 7 
dstymrlsyncdoubl e 
dstymrl syncsingl e 
Uart mode register 2. 
encoded as follows: 
Bit Name Bit # 
dstymr2baudrtl 
dstymr2baudrt2 1 
dstymr2baudrt3 2 
dstymr2baudrt4 3 
dstymr2baud50 
dstymr2baud75 
dstymr2baudll0 
dstymr2baudl3 45 
dstymr2baudl50 
dstymr2baud300 
dstymr2baud600 
dstymr2baudl200 
dstymr2baudl800 
dstymr2baud2000 
dstymr2baud2400 
dstymr2baud3600 
dstymr2baud4800 
dstymr2baud7200 
dstymr2baud9600 
dstymr2baudl9200 
dstymr2recvclock 4 
dstymr2 r ecextclk 
dstymr2 r ecintcl k 
dstymr2transclock 5 
dstymr2trnextclk 
dstymr2 trnintcl k 

6-7 
Uart command register, 
Bit Name Bit # 
dstycrtransctrl 
dstycrtcdis 



Async mode # of stop 

bits 

00 - invalid 

01-1 stop bit 

10 - 1.5 stop bits 

11-2 stop bits 

Sync mode transparent 

- normal 

1 - transparent 
Sync mode # of syncs 

- double sync 

1 - single sync 
Ihis byte is bit 

Description 
The baud rate 
Baud rate continued 
Baud rate continued 
Baud rate continued 

0000 - 50 baud 

0001 - 75 baud 

0010 - 110 baud 

0011 - 134.5 baud 

0100 - 150 baud 

0101 - 300 baud 

0110 - 600 baud 

0111 - 1200 baud 

1000 - 1800 baud 

1001 - 2000 baud 

1010 - 2400 baud 

1011 - 3600 baud 

1100 - 4800 baud 

1101 - 7200 baud 

1110 - 9600 baud 

1111 - 19200 baud 
Receiver clock 

- External clock 

1 - Internal clock 
Transmitter clock 

- External clock 

1 - Internal clock 
Reserved 

Bit encoded. 
Description 
Transmitter control 
- Disable 
transmitter 
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dstytermtype 



dstystatreg 



dstycrtcenb 

dstycrdtr 
dstycrdtrhigh 
dstycrdtrlow 

dstycrrecvcrtl 
dstycrrcdis 
dstycrrcenb 

dstycrforcebrk 
dstycrbrknorm 
dstycrbrkforce 

dstycrsenddle 
dstycrdlenonn 
dstycrdlesend 

ds tycr r eseter ror 
dstycrnoreset 
dstycrreseterr 

dstycrrts 
dstycrrtshigh 
dstycrrtslow 

dstycr ope rmodel 

dstycropermode2 



dstycromnormal 

dstycromautoecho 

dstycromst r ipdl e 

dstycromlocallp 

dstycromremotelp 
Terminal type definition 
values for each type of terminal 
Value Name Value Description 



1 - Enable 
transmitter 
Data terminal ready 

- DTR high 

1 - DTR low 
Receiver control 

- Disable receiver 

1 - Enable receiver 
Async force break 

- normal 

1 - force break 
Sync send DLE 

- normal 

1 - send DLE 
Reset error 

- normal 

1 - reset error 
Request to send 

- RTS high 

1 - RTS low 
Operating mode 
Operating mode 
continued 

00 - Normal operation 

01 - Async autoecho 
01 - Sync strip DLE 

10 - Local loop back 

11 - Remote loop back 
This byte contains 



0-15 


User defined types 


16-246 


Reserved 


dstywit 247 


WIT terminal 


dstyhydra 248 


Hydra terminal 


dstyvtlOO 250 


VT-100 terminal 


dstyvt52 251 


^^-52 terminal 


dstyt7000 252 


T-7000 terminal 


dstymg8000 253 


M3-8000 terminal 


dstytvi912c 254 


TVI 912 C terminal 


dstyvisual200 255 


Visual 200 terminal 


Uart status register. 


Bit encoded. 


Bit Name Bit # 


Description 



dstysrtransrdy 
dstysrtranfull 
SETDST-6 



Transmitter buffer 

ready 

- Transmitter full 
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dstypackette rm 



dstyflagsl 



dstysrtranempty 
dstysrrecvrdy 1 
dsty sr recvempty 
dstysrrecvfull 
dstysrdschg 2 
dstysrdsrnormal 
dstysrdsrchange 

dstysrparityerr 3 
dstysrparnormal 
dsty srpar error 



dstysroverrunerr 4 
dstysrovernormal 
dsty sr over er ror 

dstysrframingerr 5 
dsty srf r amnormal 
dsty srf ramer ror 

dstysrdcddetect 6 

dstysrdcdhigh 

dstysrdcdlow 
dstysrdsrdetect 7 

dstysrdsrhigh 

dstysrdsrlow 
Holds code for packet 
Value Name Value 



1 - Transmitter empty 
Receiver buffer ready 

- Receiver empty 

1 - Receiver full 
DSR or DCD change 

- Normal 

1 - Change in DSR or 
DCD 

Parity error 

- Normal 

1 - Async parity 
error. Sync parity 
error or DLE received 
Overrun error 

- Normal 

1 - Overrun error 
Framing error 

- Normal 

1 - Async framing 
error. Sync SYN char. 
DCD Detect 

- DCD high 

1 - DCD low 
DSR Detect 

- DSR high 

1 - DSR low 
termination characters 

Description 



dstyptnoterm 

dstyptallterm 
dstyptcrterm 

Terminal status 
Bit Name 
dstycontrolc 

dstyxonxoff 

dstycontrolx 

dstycontrolz 







Do not terminate 
packet on any control 
characters 

1 Terminate packets on 
all control characters 

2 Terminate packet on 
carriage return <CR> 
character 

information. Bit encoded. 

bit # Description 

Control C enable 
(0 = enabled) 
xon xoff enable 
(0 = enabled) 
Control X enable 
(0 = enabled) 
Control Z enable 
(0 = enabled) 
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dstycontrolo 


4 


Control enable 
(0 = enabled) 






dstytabmap 


5 


Tab map enable ' 
(1 = enabled) 






dstymask8bit 


6 


Mask 8th bit enable 
(0 = enabled) 






dstycontrolu 


7 


Control U enable 
(0 = enabled) 






dstybroadcast 


8 


Broadcast enable 
(0 = enabled) 






dstyhandshakel 


9 


Handshaking type 






dstyhandshake2 


10 








dstyhsbell 




00 - No handshake, 
send bell 






dstyhssoft 




01 - Software 
handshake 






dstyhshard 




10 - Hardware 
handshake 






dstyhsnone 




11 - No handshake, no 
bell 






dstyduplex 


11 


Full/ half duplex 
(0 = full duplex) 






dstymodemctrl 


12 


Modem control enable 
(1 = enabled) 






dstyautobaud 


13 


Auto baud enable 
(1 = enabled) 






dstyremote 


14 


Remote enable 
(1 = enabled) 


dstyinputcnt 


2 


Count of characters 


in input interrupt buffer 


dstyoutptcnt 


2 


Count of characters 


in output interrupt buffer 


dstycolumnpos 


2 


Current column 


position 


dstyinbufsz 


2 


Input buffer size in 


l bytes 


dstyoutbufsz 


2 


Output buffer i 


size in bytes 


dstywidth 


2 


The width of the given terminal screen 


dstylength 


2 


The length of 1 


bhe given terminal screen 


dstysubreadoper 


4 


Number of sub-read operations 


dsty sufcw r iteoper 


4 


Number of sub-write 


operations 


dsty reserved 


26 


Reserved 






dstyuserfield 


8 


User defined status 





For PIPE class devices the second half 
defined as follows: 



of the device status table is 
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Name 



Length 

(bytes) Description 



dsppreaderpid 

dsppwriterpid 

dspppipeid 

dsppbuffersz 

dsppbuffercnt 

dsppreserved 

dsppuserfield 



4 Process ID of pending reader 

4 Process ID of pending writer 

4 The pipe's ID 

2 The buffer size in bytes 

2 Number of characters in the pipe buffer 

40 Reserved 

8 User defined status 



For SYNC class devices the second half 
defined as follows: 



of the device status table is 



Name 



Length 

(bytes) Description 



dssymoderegl 
dssymodereg2 
dssycmdreg 
dssytermtype 



dssystatreg 

dssynumbsync 
dssyflagsl 



Mode register 1 of the uart (See DSTYM0DEREG1 

for bit definitions) 

Mode register 2 of the uart (See DSTYM0DERBS2 

for bit definitions) 

Command register of the uart ' (See DSTYCMDREG 

for bit definitions) 

Terminal type definition. A binary value. 

Value Name Value Description 



dssyibm3741 249 

dssyibm2968 250 

dssyitm2770 251 

dssyifcm3276 252 

dssyifcm3275 253 

dssyitm2780 254 

dssyibm3780 255 

Status register of uart. 

for bit definitions) t 

Number of sync characters to write 

Device Status flags. Bit encoded. 

Bit Name Bit # Description 



IBM 3741 terminal 
IBM 2968 terminal 
IBM 2770 terminal 
IBM 3276 terminal 
IBM 3275 terminal 
IBM 2780 RJE 
IBM 3780 RJE 

(See DSTySTAIRBS 



dssymultipnt 
dssyebcdic 1 
dssycrcccitt 2 



0=point to point 
l=multipoint 
0=ascii line 
l=ebcdic line 
0=crc-16 
l=crc-ccitt 
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cissy inputcnt 2 

dssyoutputcnt 2 

dssyinbufsz 2 

dssyoutbufsz 2 

dssyprevrderr 4 

dssyprevwrerr 4 

dssyprevrdtype 1 



dssynumbtrpad 1 

dssyrecsize 2 

dssyreserved 28 

dssyuserfield 8 



dssyasctoebcw 



dssyebctoascr 



dssytranstbl2 



dssylrc 3 0=crc (on above types) 

l=lrc 

4 0=no translate on 
write 

l=translate ascii to 
ebcdic on write 

5 0=no translate on read 
l=translate ebcdic to 
ascii on read 

6 0=use translate 
table 1 

l=use translate 

table 2 
Number of characters in input interrupt 
buffer 

Number of characters in output interrupt 
buffer 

Input buffer size in bytes 
Output buffer size in bytes 
Error from previous un-verif ied read 
Error from previous no-wait write 
Type of previous read 
dssynontran - Non-transparent read 
dssytran - 1 Transparent read 
The number of trailing pads to write 
Used in transparent mode with ITBs 
Reserved 
User defined status 



For NETWORK class devices the second half of the device status table is 
defined as follows: 



Name 



dsnkflags 



dsnkwindowsize 

dsnkreserved 

dsnkuserfield 



Length 

(bytes) Description 



1 

53 

8 



Device status flags. Bit encoded. 
Bit Name Bit # Description 
dsnkbyte 



dsnkmodemctrl 



0=datagram mode 
l=byte mode 
0=not enabled 
l=modem Ctrl enabled 

Window size the circuit will use 

Reserved 

User defined status 
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For NONDEV class devices the second half of the device status table 
is defined as follows: 



Name 



Length 

(bytes) Description 



dsnduserfield 



64 



User defined status 



For QUEUE class devices the second half of the device status table is 
defined as follows: 



Name 



dsquassocdev 
dsqusenddev 

dsquformname 
dsqunumexec 
dsqucurnumexec 
dsquflags 



Length 

(bytes) Description 



9 
9 

10 
2 
2 
2 



dsqulength 


2 


dsquwidth 


2 


dsqunextentry 


4 


dsqutype 


1 



A null terminated string containing the name 

of the physical printer device 

A null terminated string containing the name 

of the physical device that control messages 

are to be sent to 

A null terminated string containing the 

current form name 

This is the maximum number of entries that 

can execute concurrently 

This is the number of entries that are 

currently active 

Device Status flags Bit encoded. 

Bit Name Bit # Description 



dsquf 1 updating 
dsquflqmstay 

dsquf lnorestart 



) Currently updating 
queue control file 
L Queue manager process 
will remain running 
even when queue is 
empty 
I When queue is mounted 

it does not restart 
jobs in queue 
This holds the length of the forms of the 
printer associated with this queue 
This hold sthe width of the forms of the 
printer associated with this queue 
This is the entry number of the next entry to 
be enqued 

This contains the type of queue this is. The 
values are: 
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Value Name 



Value Description 



dsqubaseprior 



dsgureserved 
dsquuserfield 



20 
8 



dsqutpprint 1 Print type queue 

dsqutpjob 2 Job entry type queue 

This contains the priority that entries will 

be queued at if they specify the default 

priority 

Reserved 

User defined status 



To perform a set status operation the process must have write 
privilege to the device and either be the owner of the device 
(matching UICs) or have writephys privilege. 

Related Privileges: 

none - Allows access to the device only if the process 

has write privilege to the device and has the 

same owner ID and group ID (UIC) as the device, 
altuic - Allows the process to access the device if the owner 

of the image file for the current process has access 

to the device as described above, 
bypass - Allows the process to access the device without 

requiring write privilege. The process must still 

either be the owner of the device or have writephys 

privilege, 
system - Allows the process to access the device if the system 

has write privilege to the device as described above. 

(This does not obviate the need for device ownership 

or writephys privilege) . 
writephys - Allows physical access to devices as described above. 

(This does not obviate the need for write privilege) . 



Parameters: 



dname 



- Address of a null terminated string containing 
the name of the device whose status table is 
to be written. This string will be translated 
automatically by the MCS to its logicl equivalent. 
This string may contain up to 93 valid characters 
followed by a null. 

If this string contains a file designation , the 
devicename portion of the file designation is used for 
this parameter. 
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dstat 
status 

Diagnostics : 



- Address of the 128 byte device status table that 

is to be written. This buffer must be word aligned. 

- Address of a long word to receive the result of 
the operation. 



errinsufpriv (1) 

errinvdevnam (130) 

errundevnam (131) 

errnowritepriv (145) 

errinvdrvnum (311) 



The process lacks the privileges required to 

perform the operation. 

The specified devicename is syntactically 

incorrect. 

The MCS does not recognize the devicename. 

Is the device mounted? 

The process does not have Write Privilege for 

the file. 

A value in at least one field of the devicename 

is disallowed. 



See Also: 



_getdnam 

_getdst 

_giodst 

_physop 

_siodst 



Get devicename 

Get device status 

Get device status with LUN 

Perform physical device operation 

Set device status with LUN 



Assembler Calling Sequence: 

%%sys$disk/sysincl . sys/dstatdisp. asm 

push dname ; address - devicename 

push dstat ; address - device status 

push status ;address - result of the operation 

jsr _setdst ;set device status 

C Function Declaration: 

♦include "sys$disk/sysincl . sys/dstatdisp. h n 



long 

_setdst (dname, dstat) 

char dname [94] ; 

devicestatus dstat; 



/* set device status */ 

/* returns result of the operation */ 

/* devicename */ 
/* device status */ 
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FORKAN Subroutine Declaration: 

c I set device status 

subroutine _setdst (dname r dstat, status) 
character *94 dname I devicename 
character* (*) dstat 1 device status 
integer *4 status ! result of the operation 

Pascal Procedure Declaration: 

%%sys$disk/sysincl . sys/dstatdisp. pas 

procedure _setdst( {** set device status) 

dname : string [93]; {** devicename) 
dstat : *array_ofL_char; {** device status) 
var status : longint {** result of the operation) 

) ; external ; 
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_SEnxnc 



Set device UIC. 



Description: 

This system call allows a process to change the user identification 
code (UIC) of a device. By changing the UIC, the ownership of the 
device is changed. 

To successfully change the UIC of a device, the calling process must 
have operator privilege, and either group privilege or world 
privilege. 

If the calling process has group privilege, and the group ID of the 
device is the same as the group ID of the calling process, the 
process can modify the owner ID of the device. 

If the calling process has world privilege and operator privilege, it 
can change the UIC of any device to be any other UIC except zero. 

This system call is valid for any class of device. 

Related Privileges: 

none - The process cannot change the UIC of the device, 
group - If the process also has operator privilege, it can 

modify the owner ID of any mounted device which has 

the same group ID as the calling process, 
operator - Allows setting the UIC if the process also has either 

group or world privilege, 
world - If the process also has operator privilege it can modify 

the UIC of any mounted device to any other UIC except 

zero. 



Parameters; 
dname 



uic 



- Address of a null terminated string containing the name 
of the device whose UIC is to be changed. This string 
will be translated automatically by the WMCS to its 
logical equivalent. This string may contain up to 93 
valid characters followed by a null byte. If this string 
contains a file designation, the devicename portion of 
the file designation is used for this parameter. 

- A long word containing the user identification code. 
This long word is divided into to*o fields. The most 
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status 



significant 16 bits constitute the owner ID number. The 
least significant 16 bits constitute the group ID number 
(identifying the group to which the user belongs) . 

The value $FFFFFFFF (-1) is a reserved value that means 
to use the default UIC, i.e., the UIC of the calling 
process. 

A value of zero is invalid. 

Address of a long word to receive the result of the 

operation. 



Diagnostics : 

errinsufpriv (1) 

errinvdevnam (130) 

errundevnam (131) 

See Also: 



The process lacks the privileges required to 

perform the operation. 

The specified devicename is syntactically 

incorrect. 

The MCS does not recognize the devicename. Is 

the device mounted? 



_getduic - Get device UIC 
_getfuic - Get file UIC 
_getuic - Get process UIC 
_setfuic - Set file UIC 
_jsetuic - Set process UIC 

Assembler Calling Sequence: 

push dname 

push uic 

push status 

jsr _setduic 

C Function Declaration: 



long 

.jsetduic (dname , uic) 

char dname [ 94]; 

long uic; 



; address - devicename 

; value - owner ID code 

; address - result of the operation 

;set device UIC 



/* set device UIC */ 

/* returns result of the operation */ 

/* devicename V 
/* owner ID code */ 



SETOUIC-2 



Dictionary of WMCS System Calls 

_jsetduic 



FORTRAN Subroutine Declaration: 



c ! set device UIC 

subroutine setdui (dname f uic, status) 
character *94 dname I devicename 
integer*4 uic 1 owner ID code 
integer *4 status ! result of the operation 

Pascal Procedure Declaration: 

procedure __setduic( {** set device UIC} 

dname : string [93]; {** devicename} 

uic : longint; {** owner ID code} 

var status : longint {** result of the operation} 

) ; external ; 
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Set event flags. 

Description: 

All the event flags corresponding to 1 bits in the mask provided will 
be set in the event flags of the specified process. 

Related Privileges: 



none 
group 
world 
Parameters: 
pid 
efmask 
status 



- Allows setting event flags in processes with the same 
owner ID and group ID (UIC) as the calling process. 

- Allows setting event flags in processes with the same 
group 3D as the calling process. 

- Allows setting event flags in any process. 



- Process ID of the process whose event flags are to be 
set. 

- Event flag mask. Contains the mask representing which 
event flags are to be set. 

- Address of a long word to receive the result of the 
operation. 



Diagnostics : 

errinsufpriv 
errprcsnotfnd 

See Also: 



(1) The process lacks the privileges required to 
perform the operation. 

(2) The specified process is not in the system 
process table. 



_andevnt - Wait for AND of event flags 
_clrevnt - Clear event flags 
_getevnt - Read event flags 
_orevnt - Wait for OR of event flags 



Assembler Calling Sequence: 



push 
push 
push 
jsr 



pid 
efmask 
status 
_setevnt 



; value - process ID 

;value - event flag mask 

; address - result of the operation 

;set event flags 
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C Function Declaration: 



long 

_setevnt(pid, efmask) 

long pid; 

long efmask; 

FORTRAN Subroutine Declaration: 



/* set event flags */ 

/* returns result of the operation */ 



/* process ID */ 
/* event flag ma 



mask */ 



! set event flags 
subroutine setevn(pid f efmask, status) 
integer *4 pid 
integer *4 efmask 
integer*4 status 



process id 
I event flag mask 
1 result of the operation 



Pascal Procedure Declaration: 

procedure _jsetevnt( 

pid : longint; 

efmask : longint; 
var status : longint 
) ; external ; 



{** set event flags} 

{** process ID} 

{** event flag mask} 

{** result of the operation} 
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setexit 



setexit - Define exit handler. 

Description: 

The user may define an exit handler to be executed when 
the process is deleted. An exit handler can be used as a 
cleanup and restore routine or as a mechanism for "catching" 
otherwise fatal errors. Exit routines can determine the 
reason they are called by using the .errno system call to retrieve 
the process abort code. All return code values -65535 and 
+65535 are reserved to MCS. All numbers beyond this range 
are reserved for users to define as they wish. Exit routines 
cannot have have any call arguments. 

The exit handler for a process is executed when a process 
exits regardless of the cause or circumstances of the exit. 
The exit handler is executed in the same processor mode 
(user of supervisor mode) as the mode from which the exit 
handler was defined or was executed , which ever is higher. 

When control is passed to the exit handler the OS notes that 
the process is executing its exit handler. If a fatal process 
error occurs while the process is executing its exit handler , 
the process will be deleted without passing through the exit 
handler again. If the process wants an exit handler to be called 
again as the process exits, it must define a new exit handler 
while it is executing its exit handler- Since no further abort 
conditions will be honored until the next time the process is 
scheduled, a carefully written exit handler can determine the 
reason for being transferred to the exit handler and be able to 
define a new one if necessary - 

To terminate the process normally once the exit handler has been 
called, issue a call to _exproc from within the exit handler. 

When an exit handler is called, the registers contain the context 
of the process at the point it was interrupted. The return address 
and status register of the interrupted process are at bytes 2 and 
respectively from the top of the stack. Return to the main, 
process can be effected by executing an KTR or RTE instruction. 
Because an exit handler is capable of being called asynchronously 
in relation to the main process, changing global variables from 
within an exit handler may cause seemingly mysterious results when 
control is returned to the main body of a process which uses those 
same variables. 
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Address of the exit handler routine. 



Related Privileges: 

None. 
Parameters : 

adr 
Diagnostics : 

None. 

See Also: 

_errno - Receive process abort reason 
_exitrtn - Define a returnable exit handler 
_exproc - Terminate the specified process 



Assembler Calling Sequence: 



push 
jsr 



adr 
_setexit 



C function declaration: 

void 
_setexit (adr) 

long adr; 

Fortran Subroutine Declaration: 

c 

subroutine setexi(adr) 
external adr 

Pascal Procedure Declaration: 

procedure setexit ( 

adr : longint 
) ; external; 



;value - address of exit handler 
; define exit handler 



./* define exit handler */ 
/* no result */ 

/* address of exit handler */ 



! define exit handler 
I address of exit handler 



{** define exit handler} 
{** address of exit handler} 
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Write file control block. 
Description: 



This SVC allows the calling process to update the file control block 
for an open file on any disk class device. Note that this requires 
that the calling process have writephys privileges and have write 
access to the file. For security reasons the file should have been 
opened with write locked access. 

NOTE: The PCB file is the heart of the file system. Careless 
tampering with the PCB file can cause severe damage to the 
file system's integrity. 

CAUTION: The format of the file control block my change with 
each release. The current definition is included in 
each release in the file /SysiNCL.sys/FCBDISP.*. The 
name of the PCB record is "fcbtype," i.e. , in your 
program you can declare a variable whose type is 
"fcbtype." 

There are several variations on the format of file control blocks , 
depending on the class of device which contains the file. Disk files 
contain "primary" PCBs and "continuation" PCBs. Tape files have 
"tape" PCBs. All other files have "tty" PCBs. You can only set the 
PCB for disk class devices. 

The format of the first 14 bytes of the PCB record is the same for 
all types of PCBs. The format of this common type is: 



Name 



Length 

(bytes) Description 



fcbnum 



fcbseqnum 



FCB number for this PCB. The record number 
of this record within the PCB file. For tty 
FCBs, the value of this field is zero. This 
field may not be changed. 
FCB sequence number. This number is unique 
for each usage of this FCB. For tty PCBs r the 
value of this field is zero. This field may 
not be changed. 
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fcbcontfcbnum 



fcbcontfcbseq 



fcbusageid 



PCB number of continuation PCB. The record 
number of the next PCB for this same file. For 
tape and tty PCBs, the value of this field is 
zero. This field may be zeroed (remove a 
continuation) but no other values may be set 
(add a continuation) . 

Sequence number of the continuation FCB. For 
tape and tty FCBs, the value of this field is 
zero. This field may be zeroed (remove a 
continuation) but no other values may be set 
(add a continuation) . 

Usage ID field. The type of PCB. Values are: 



fcbunalloc 

fcballocroot 
fcballoccont 



This PCB is unused. The 

data in this record is 

invalid. 

This record contains a 

root PCB. 

This record contains a 

continuation PCB. 



fcbextusecnt 



Number of extent fields in use within this PCB, 



The format of the last 242 bytes of the PCB is different for 
"primary" FCBs as opposed to "continuation" FCBs. For primary PCBs 
(diskf tape and tty) the format is as follows: 



fcbfiletype 



File type. For tty files , it is always set 
to zero (a data file) . Valid file types are: 
File Type Value Description 



fcbfilename 



fcbftdata 





data file 


fcbftdir 

fcbftimage 

fcbftksamdata 


1 
2 
3 


directory file 
image file 
KSAM data file 


fcbftksamkey 
fcbf til image 
fcbftarchcont 


4 
5 
6 


KSAM key file 
LL image file 
archive file continuation 


fcbftencrypt 
fcbf tsy stem 
fcbftarchive 


7 
8 
9 


encrypted file 
system file 
archive file 




20-255 


reserved 


256-65535 


1 user-defined file types 


Filename. For 


disk and tape files it contains 


the filename portion of the file designation. 
For tty files it contains the devicename. 



SETPCB-2 



Dictionary of MCS System Calls 

_setfcb 



fcbfileext 3 

fcbfilevers 2 

fcbdirfcbnum 4 

fcbdirseqnum 2 



fcbrecordsz 

fcbuserid 

fcbgroupid 

fcbprotect 

fcbcreatemstim 



fcbcreatelstim 



fcbmodmstim 


4 


fcbmodlstim 


4 


fcbreserved 
fcbphysicalsz 


4 
4 


fcblogicalsz 


4 


fcbfileid 


2 


fcbrootextblk 


180 



fcbnotcksum 



File extension. For tty FCBs this field is set 

to zero. 

File version number. For tty FCBs this field is 

set to zero. 

Directory FCB number. "Hie PCB number of the 

directory file containing this file. For tape 

and tty FCBs it contains zero. 

Directory sequence number. The sequence number 

of the directory file containing this file. 

For tty FCBs this field contains zero. 

Default record size. For tty FCBs this field is 

set to 1. 

Owner ID of the file's owner. 

Group ID of the file's owner. 

File protection field. For tty FCBs it contains 

the device protection. 

The most significant 32 bits of the file 

creation date in system time format (year and 

day) . For tty FCBs, it contains the year and 

day that the device was mounted. 

The least significant 32 bits of the file 

creation date in system time format (hour, 

minute, ...) . For tty FCBs, it contains the 

hour, minute, ... that the device was mounted. 

The most significant 32 bits of the date the 

file was last modified (year and day) . For tty 

FCBs, it contains the year and day that the 

device was mounted. 

The least significant 32 bits of the date the 

file was last modified (hour, minute, second, 

tick) . For tty FCBs, it contains the hour, 

minute, ... that the device was mounted. 

Reserved space. 

The physical size of the file in bytes. 

For tty FCBs this field is set to zero. 

The logical size of the file in bytes. 

For tty FCBs this field is set to zero. 

File ID of the file. For tty FCBs this field 

is set to zero. 

File extent fields. There are 30 extent fields 

in a primary PCB. Each extent field is 

composed of 6 bytes. The first two bytes 

represent the number of sectors in that 

extent. The last four bytes are the logical 

sector number of the first sector in that 

extent. 

The FCB's notted checksum. 
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The format of the last 242 bytes of the PCB 
(disk only) is as follows: 



for "continuation" PCBs 



fcbcontextblk 240 



fcbnotcksum 
Related Privileges: 



File extent fields in a continuation PCB. 
There are 40 extent fields in a continuation 
FCB. Each extent field is composed of 6 bytes. 
The first two bytes represent the number of 
sectors in that extent. The last four bytes 
are the logical sector number of the first 
sector in that extent. 
The PCB's notted checksum. 



none - Cannot write the PCB 

writephys - Allows the process to update the PCB if the process 
also has write access to the file. 



Parameters: 
lun 
cont 
fcbuff 
status 



- Logical unit number of the file whose PCB is being 
updated. 

- Which part of the PCB for this file is to be updated. 
0=root FCB, l=first continuation FCB, etc. 

- Address of a 256 -byte buffer containing the FCB to be 
written. This buffer must be word aligned. 

- Address of a long word to receive the result of the 
operation. 



Diagnostics: 

errinsufpriv 

erridxrange 
errinvlfn 



(1) 

(56) 
(132) 



errnowriteacc (142) 



The process lacks the privileges required to 

perform the operation. 

The table ends before the specified occurrence. 

The logical unit number does not correspond to 

an open file. 

The process does not have write-access to the 

specified file. 



See Also: 



_create 
_getfcb 
_open 
_setfprt 



Create a file 

Get file control block 

Open a file 

Set file protection 
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Assembler Calling Sequence: 



push 


lun 


push 


cont 


push 


fcbuff 


push 


status 


jsr 


_setfcb 



C Function Declaration: 



;value - logical unit number 
; value - continuation FCB number 
; address - buffer containing FCB 
; address - result of the operation 
;write file control block 



#include n sys$disk/sysincl.sys/fcbdisp.h n 

/* write file control block */ 



long 

_setfcb(lun, cont, fcbuff) 

long lun; 

long cont; 

fcbtype fcbuff; 

FORERAN Subroutine Declaration: 



/* returns result of the operation */ 

/* logical unit number */ 
/* continuation FCB number */ 
/* buffer containing FCB */ 



! write file control block 



subroutine setfcbdun, cont, fcbuff, status) 



integer *4 lun ! 
integer *4 cont ! 
character* (*) fcbuff 
integer *4 status ! 



logical unit number 
continuation FCB number 
! buffer containing FCB 
result of the operation 



Pascal Procedure Declaration: 

%%sys$disk/sysincl . sys/fcbdisp.pas 



procedure _setfcb( 

lun : 

cont : 

fcbuff : 

var status : 

) ; external ; 



{** write file control block) 
longint; {** logical unit number) 
longint; {** continuation FCB number) 
~array_of_char; (buffer containing FCB) 
longint {** result of the operation) 
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_SETFID 
Set file ID. 

Description: 

Allows a process to change the file indentif ication code (fid) 

on an open file. The file identification code is a 16 bit 
word which can have any value. 

This operation is valid on any disk file. 

To successfully change the fid, the process must have 
successfully opened the file for write access. 

Related Privileges: 

None. 

Parameters : 

lun - Logical unit number of the file whose file id 

is to be changed, 
fid - The value to be assigned to the fid field for 

this file, 
status - Address of a long word to receive the result of 

the operation. 

Diagnostics : 

errnomemavail (7) All available memory has been allocated, 
ermowriteacc (142) The process does not have write-access 

to the specified file, 
errinvcloper (173) The device class is inappropriate for the 

operation. 

Device integrity errors 

See Also: 

jgetfid - Get file id 

Assembler Calling Sequence: 

;value - logical unit number 
;value - file id 

jaddress - result of the operation 
;set file id 



push 


lun 


push 


fid 


push 


status 


jsr 


setf id 



C Function Declaration: 



/* set file id */ 
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long 

_setfid(lun, fid) 

long lun; 

long fid; 

Fortran Subroutine Declaration: 



/* returns result of the operation * t 

/* logical unit number */ 
/* file id */ 



! set file id 

subroutine setfid(lun, fid, status) 

integer*4 lun ! logical unit number 

integer*4 fid ! file id 

integer*4 status ! result of the operation 



Pascal Procedure Declaration: 

procedure __setfid( 

lun : longint; 

fid : longint; 
var status : longint 
) ; external ; 



{** set file id} 

{** logical unit number} 

{** file id} 

{** result of the operation} 
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_SETFPRT 

Set file protection. 

Description: 

Establishes the protection to be applied to a file. 
The protection grants access privileges to the file 
for classes of users. 

This operation is valid for files on any mounted device 
except tape class devices. 

To successfully change protection on a file the 

process must have successfully opened the file. In addition, 

the process must have bypass privilege or operator privilege 

or have the same owner id and group id (uic) as the file 

itself. 

Related Privileges: 

None - Allows the owner of a file to modify the protection. 

altuic - Allows the process to change the protection if the 

owner of the process's image file is the same as 

the owner of the file, 
bypass - Allows the process to change the protection on any 

file independent of file protection, 
operator - Allows the process to change the protection on any 

file independent of file protection. 

Parameters : 

lun - The logical unit number of the file whose protection 
is to be set. 

prot - File protection mask. The least significant 
16 bit word of this parameter is divided into 
4 nibbles. Each nibble corresponds to a class 
of users. The bits within each nibble represent 
the type of access that class of user is granted 
for this file. If the bit is set (1) the access 
is granted. 

From the least to the most significant nibble 
the user classes are: 

Ownr - file owner 

Grp - processes with the same group id as the owner 

Pub - all other processes in the system 

Sys - processes with SYSTEM privilege 

Sys Pub Grp Ownr 
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I 1 , , 1 

| DWRE | DWRE | DWRE | DWRE | 

MSB LSB 

From the least to the most significant bits within 
the nibbles, the access privileges are: 

E - Execute access 

R - Read access 

W - Write access 

D - Delete access 

A long word -1 is a reserved value that means that 
the users default protection mask is to be used. 

status - Address of a long word to receive the result of 
the operation. 



Diagnostics: 

errinsufpriv 

errinvlfn 

errinvcloper 

See Also: 



(1) The process lacks the privileges required to 

perform the operation. 
(132) The logical unit number does not correspond 

to an open file. 
(173) The device class is inappropriate for the 

operation. 



_create - Create a file 
_getfcb - Get file control block 
setfcb - Write file control block 

Assembler Calling Sequence: 



push 


lun 


push 
push 


prot 
status 


jsr 


setfprt 


C function 


declaration: 


long 
setfprt(lun, prot) 
long lun ; 
long prot; 



;value - logical unit number 

;value - protection mask 

jaddress - result of the operation 

;set file protection 



/* set file protection */ 

/* returns result of the operation */ 

/* logical unit number */ 
/* protection mask */ 



Fortran Subroutine Declaration: 
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! set file protection 

subroutine setfpr(lun, prot, status) 

integer*4 lun ! logical unit number 
integer*4 prot ! protection mask 
integer*4 status ! result of the operation 



Pascal Procedure Declaration: 



procedure _setfprt( 

lun : longint; 

prot : longint; 
var status : longint 
) ; external ; 



{** set file protection} 

{** logical unit number} 

{** protection mask} 

{** result of the operation} 
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Set file record size. 

Description: 

Sets new current file record size on an open file. The file record 
size is the number of bytes returned when one record is requested 
from the operating system. All files have a default record size that 
was specified when the file was created or opened. This system call 
overrides the current record size. 

Related Privileges: 

None. 



Parameters: 
lun 

newrsz 
status 

Diagnostics : 
errinvlfn 

See Also: 



Logical unit number of the file whose record size 

is to be changed. 

The new record size for this file. Only the low order 

16 bits of the longword are used. 

Address of a long word to receive the result of 

the operation. 



(132) The logical unit number does not correspond 
to an open file. 



_getf rsz - Get file record size 
Assembler Calling Sequence: 



push 


lun 


push 
push 
jsr 


newrsz 
status 
_setfrsz 



-; value - logical unit number 
; value - new record size 
;address - result of the operation 
;set file id 
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C Function Declaration: 



long 

_setfrsz(lun, newrsz) 

long lun; 

long newrsz; 

FORTRAN Subroutine Declaration: 



/* set file id V 

/* returns result of the operation */ 

/* logical unit number */ 
/* new record size */ 



I set file id 
subroutine _setfrsz(lun, newrsz, status) 



integer *4 lun 
integer *4 newrsz 
integer *4 status 

Pascal Procedure Declaration: 

procedure _jsetfrsz( 

lun : longint; 
newrsz : longint; 
var status : longint 
) ; external ; 



! logical unit number 

! new record size 

I result of the operation 



{** set file id} 

{** logical unit number) 

{** new record size) 

{** result of the operation) 
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Set file UIC. 

Description: 

This allows a process to change the user identification code 
(uic) on a given file. By changing the uic the ownership of 
the file is changed. 

This operation is valid for any disk file. 

To successfully change the uic of a file, the calling 

process must have successfully opened the file. In addition, 
the calling process must have operator privilege, and 
either group privilege or world privilege. 

If the calling process has group privilege, and the group 
id of the file is the same as the group id of the calling 
process, the process can modify the owner id of the file. 

If the calling process has world privilege and operator 
privilege it can change the uic of any file to be any 
other uic except zero. 

Related Privileges: 

none - The process cannot change the uic of the file, 
group - If the process also has operator privilege, it can 

modify the owner id of any disk file which has 

the same group id as the calling process, 
operator- Allows setting the uic if the process also has 

either group or world privilege, 
world - If the process also has operator privilege it can 

modify the uic of any disk file to any other uic 

except zero. 

Parameters : 

lun - A long word containint the logical unit number of 

the file whose uic is to be changed, 
uic - A long word containing the uic that the file will 

receive. This long word is divided into two fields. 
The most significant 16 bits constitute the owner 
id number. The least significant 16 bits constitute 
the group id number (identifying the group to which 
the user belongs. 

A long word -1 ($FFFFFFFF) is a reserved value that 

means to assign the default uic, i.e. the uic of the 
calling process. 
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status - Address of a long word to receive the result of 
the operation. 



Diagnostics : 

errinsufpriv 

errinvlfn 
errinvcloper 

See Also: 



(1) The process lacks the privileges required to 

perform the operation. 
(132) The logical unit number does not correspond 

to an open file. 
(173) The operation is inappropriate for the 

device class. 



_getdst - Get device status 
getduic - Get device uic 
getfcb - Get file control block 
"getfuic - Get file uic 
getuic - Get process uic 
"setduic - Set device uic 
setfcb - Write file control block 
setuic - Set process uic 



Assembler Calling Sequence: 



push 


lun 


push 


uic 


push 


status 


jsr 


setfuic 



C function declaration: 



long 
_setfuic(lun, uic) 

long lun; 

long uic; 

Fortran Subroutine Declaration: 



jvalue - logical unit number 
;value - the new uic 
jaddress - result of the operation 
;Set file uic 



/* set file uic */ 

/* returns result of the operation */ 

/* logical unit number */ 
/* the new uic */ 



! set file uic 
subroutine setfui(lun, uic, status) 



integer*4 lun 
integer*4 uic 
integer*4 status 

Pascal Procedure Declaration: 

procedure _setfuic( 

lun : longint; 
uic : longint ; 



! logical unit number 

! the new uic 

! result of the operation 



{** set file uic} 

{** logical unit number} 

{** the new uic} 
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var status : longint 
) ; external ; 



{** result of the operation} 
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setmprt 



setaiprt - Change access protection of a named shared memory area. 

Description: 

_Setmprt is used to establish the protection of a named 
sharable memory area. The protection grants access privileges 
to the named memory area for classes of users. 

To successfully change the protection on a named sharable memory 
area the process must have the same owner id and group id (uic) 
as the memory area, or have operator privilege, or have bypass 
privilege. 

Related Privileges: 

none - Allows modifying the protection of a named shared memory 

area which has the same owner as the process, 
altuic - Allows modifying the protection of a named shared memory 

area if the owner of the process's image file is the same 

as the owner of the memory area, 
bypass - Allows the process to modify the protection of any named 

shared memory area, 
operator- Allows the process to modify the protection of any named 

shared memory area. 



Parameters : 
mname 



prot 



Address of a null terminated string identifying 

the specific memory area. This string will be 

translated automatically by WMCS into its 

logical equivalent. This string may contain up 

to 93 significant characters followed by a null. 

Protection mask. The least significant 

16 bit word of this parameter is divided into 

4 nibbles. Each nibble corresponds to a class 

of users. The bits within each nibble represent 

the type of access that class of user is granted 

for this memory area. If the bit is set (1) the access 

is granted. 

From the least to the most significant nibble 
the user classes are: 

Ownr - owner of the memory area 

Grp - processes with the same group id as the owner 

Pub - all other processes in the system 
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Sys - processes with SYSTEM privilege 
Sys Pub Grp Ownr 
IEWREIEWRE IEWRE IDWRE I 



MSB LSB 



From the least to the most significant bits within 
the nibbles, the access privileges are: 

E - Execute access 

R - Read access 

W - Write access 

D - Delete access 

The value $FFFFFFFF (-1) is a reserved value that 
means that the users default protection mask is to 
be used. 

status - Address of a long word to receive the result of 
the operation. 

Diagnostics : 

errnoname ( 82) The name specified does not exist. 

See Also: 

_defmem - Define a named sharable memory area. 

_udefmem - Undef ine a named sharable memory area. 

_shrmem - Share a named sharable memory area. 

_ushrmem - Unshare a named sharable memory area. 

_getmlst - Get a list of named sharable memory areas. 

_setmuic - Change owner of a named sharable memory area. 



Assembler Calling Sequence: 



push 


mname 


push 


prot 


push 


status 


jsr. 


_setanprt 



address - name of memory area 
value - new protection 
address - result of the operation 
Change protection of a memory area, 



C Function Declaration: 



/* change protection of a memory area */ 
long /* returns result of the operation */ 

_setmprt (mname #prot) 

char mname [94]; /* name of memory area */ 
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long prot; 
FORTRAN Subroutine Declaration: 



subroutine setmpr (mname 
character*94 raname 
integer*4 prot 
integer*4 status 

PASCAL Procedure Declaration: 

procedure _setmprt( 

mname : string [93]; 

prot : longint; 
var status : longint 
) ; external; 



/* new protection */ 



! change protection of a memory area 
prot. status) 
! name of memory area 
! new protection 
! result of the operation 



{** change protection of a memory area} 

{** name of memory area} 

{** new protection } 

{** result of the operation} 
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setmuic - Set named memory area uic. 

Description: 

_setaiuic is used to change the user identification code (uic) 
of a named sharable memory area. 

To successfully change the uic of a named sharable memory area 
the calling process must have operator privilege, and either 
group privilege or world privilege. 

If the calling process has group privilege and operator 
privilege, and the group id of the named sharable memory 
area is the same as the group id of the calling process, 
the process can modify the owner id of the named sharable 
memory area. 

If the calling process has world privilege and operator 
privilege it can change the uic of any named sharable memory 
area to be any other uic except zero. 

Related Privileges: 

none - Does not allow changing the UIC of a named shared 

memory area. Note: __setmuic will return successfully 
if the specified UIC is the same as the current UIC. 

group - If the process also has operator privilege, and the 
group id of the process is the same as the group id 
of the specified named sharable memory area, the process 
is allowed to modify the owner id portion of the uic. 

operator- Allows the process to change the UIC of any named shared 
memory area if the process also has either group or 
world privilege. 

world - If the process also has operator privilege, the process 

is allowed to modify the uic of the named sharable memory 
area to any uic except zero. 

Parameters : 

mname" - Address of a null terminated string identifying 

the specific memory area. This string will be 
translated automatically by WCS into its 
logical equivalent. This string may contain up 
to 93 significant characters followed by a null. 

uic - A long word containing the UIC number of the new 

owner of the named shareable memory area. 

status - Address of a long word to receive the result of 
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the operation. 



Diagnostics : 

errinsufpriv 
errnoname 

See Also: 

_defmem 

_udefmem - 

__shrmem — 

__ushrmem - 

_getmlst - 

_setmprt - 



( 1) 



The process lacks the privileges required 
to perform the operation. 
82) The name specified does not exist. 



Define a named sharable memory area. 

Undefine a named sharable memory area. 

Share a named sharable memory area. 

Unshare a named sharable memory area. 

Get a list of named sharable memory areas. 

Change protection of a named sharable memory area. 



Assembler Calling Sequence: 



push 
push 
push 
jsr 



mname 
uic 

status 
_setmuic 



address - name of memory area 
value - user identification code 
address - result of the operation 
Set named memory area uic. 



C Function Declaration: 



long 

_setmuic (mname -uic) 

char mname [94] ; 

long uic; 

FORTRAN Subroutine Declaration: 



/* set named memory area uic */ 

/* returns result of the operation */ 

/* name of memory area */ 

/* user identification code */ 



! set named memory area uic 
subroutine setnui (mname » uic, status) 

character*94 mname ! name of memory area 
integer* 4 uic ! user identification code 
integer*4 status ! result of the operation 



PASCAL Procedure Declaration: 

procedure setmuic ( 

mname : string [93]; 

uic : longint; 
var status : longint 
) ; external; 



{** set named memory area uic} 
{** name of memory area} 
{** user identification code} 
{** result of the operation} 
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_SETPNAM 

Change process name. 

Description: 

Allows a process to set its own process name or give 
another process a new process name. The calling process 
must have operator privilege to change the process name. 

Related Privileges: 

None - The calling process can not change the process 

name on any process, 
operator - The calling process can change the process name 

on any process with the same owner id and group 

id (uic). 
group - If the calling process has operator privilege it can 

change the process name of any process with the same 

group id. 

world - If the calling process has operator privilege it can 
change the process name of any process in the system. 

Parameters : 

pid - Process ID of the process whose process name is to 
be changed. refers to the calling process, -1 
refers to the parent of the calling process. 

pname - Address of a 17 byte null terminated string 

containing the new process name to be given to 
the specified process, (up to 16 valid characters 
followed by a null) 

status - Address of a long word to receive the result of 
the operation. 

Diagnostics : 

errinsufpriv (1) The process lacks the privileges required to 

perform the operation, 
errprcsnotfnd (2) The specified process is not in the system 

process table. 

See Also: 

_crproc - Create a new process 
_getpcb - Get Process Control Block 
_getpnam - Get process name from pid 

Assembler Calling Sequence: 

push pid ;value - process id 
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push 


pname 


push 


status 


jsr 


setpnam 



C function declaration: 



long 

_setpnam(pid, pname) 

long pid; 

char pname [ 17] ; 

Fortran Subroutine Declaration: 



;address - process name 

;address - result of the operation 

; Change process name 



/* change process name */ 

/* returns result of the operation */ 



/* process id */ 
/* process name */ 



! change process name 
subroutine setpna(pid, pname, status) 



integer*A pid 
character* 17 pname 
integer*4 status 

Pascal Procedure Declaration: 



! process id 

! process name 

! result of the operation 



procedure _setpnam( 

pid : longint; 
pname : string [16]; 
var status : longint 

) ; external ; 



{** change process name} 

{** process id} 

{** process name} 

{** result of the operation} 



SETPNAM-2 



_SETPOS 

Set the current file position. 

Description: 

Given a valid logical unit number (lun), sets the default 
position of the file pointer in an open file. If the next 
file access uses the default record number (-1) the 
transfer will begin at this file position. 

This is the complementary operation to _getpos. 

Note that this system call is not required for random file 
access on disk since all _read and _write system calls 
allow the process to specify a record number. It is, however, 
the only method of achieving pseudo random access on a 
tape. Setting the file position with this system call will 
position the tape correctly to the specified record within 
the file. 

Related Privileges: 

None. 
Parameters : 

lun - A long word containing the logical unit number of 
the file whose position is to be set. 

recnum - The record number to which the file position is 
to be set. This is an unsigned long word. 

status - Address of a long word to receive the result of 
the operation. 

Diagnostics : 

errinvlfn (132) The logical unit number does not correspond 

to an open file, 
errreadleof (140) The process tried to read past the logical 

end of a file. 

Device integrity errors 

See Also: 

_getpos - Get the current file position 

read - Read from an open file 
write - Write to an open file 

Assembler Calling Sequence: 

push lun ;value - logical unit number 
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push recnum 
push status 
jsr _setpos 

C function declaration: 



long 
setpos (lun, recnum) 
long lun; 
long recnum; 

Fortran Subroutine Declaration 



;value - record number 

;address - result of the operation 

;set the current file position 



/* set the current file position */ 
/* returns result of the operation */ 

/* logical unit number */ 
/* record number */ 



! set the current file position 
subroutine setpos (lun, recnum, status) 

integer*4 lun ! logical unit number 
integer*4 recnum ! record number 
integer*4 status ! result of the operation 



Pascal Procedure Declaration: 

procedure _setpos( 

lun : longint; 

recnum : longint; 
var status : longint 
) ; external ; 



{** set the current file position} 

{** logical unit number} 

{** record number} 

{** result of the operation} 



SETPOS-2 



_SETPRI 



Change a process's priority. 
Description: 



Allows a 



process to set its own scheduler priority or the priority of 
another process. There are 16 priority levels numbered 0..15. 
Priority level is the highest. 

A process may lower the priority of any process which it can affect, 
but it must have setprior privilege in order to increase the priority 
of any process. 

Related Privileges: 



none 
group 

world 
setprior 

Parameters: 



- Allows the process to affect the priority of 

any process with the same owner id and group id (uic) 
as the calling process. 

- Allows the process to affect the priority of 

any process with the same group id as the calling 
process. 

- Allows the process to affect the priority of 
any process in the system. 

- Allows the process to raise the priority of any 
process which it can affect. 



pid - A long word containing the process ID of the process 
whose priority is to be changed. refers to the 
current process, -1 refers to the parent of the 
current process. 

priort - A long word containing the priority level (0..3) 
desired. Uses this value modulo 4 so that no out 
of range errors are detected. If the value of 
this parameter is -1 ( $FFFFFFFF) , it means to use 
the same priority of the calling process. 

status - Address of a long word to receive the result of 
the operation. 



Diagnostics : 

errinsufpriv 
errprcsnotfnd 



(1) The process lacks the privileges required to 
perform the operation. 

(2) The specified process is not in the system 
process table. 
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See Also: 



_getpri - Get process's priority 
_prirat - Set priority scheduling ratio 
_settmsl - Change scheduling time slice 



Assembler Calling Sequence: 

push pid 

push prior t 

push status 

jsr _setpri 

C Function Declaration: 



long 
_setpri 



(pid, prior t) 
long pid; 
long priort; 



; value - process id 
;value - new priority level 
;address - result of the operation 
; change process's priority 



/* change process's priority */ 

/* returns result of the operation */ 

/* process id */ 

/* new priority level */ 



FORTRAN Subroutine Declaration: 



! change process's priority 
subroutine _setpri(pid, prior t, status) 

I process id 
! new priority level 
! result of the operation 



integer *4 pid 
integer *4 priort 
integer *4 status 



Pascal Procedure Declaration: 



procedure _setpri( 

pid : longint; 
priort : longint; 
var status : longint 
) ; external ; 



{** change process's priority } 

{** process id) 

{** new priority level) 

{** result of the operation) 
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_SETEW 



Set process privilege. 

Description: 

Allows a process to acquire and relinquish various privileges as 
assigned by the process privilege word. A process must have setpriv 
privilege in order to assign privileges which it does not already 
have. 

Related Privileges: 



none 
group 

setpriv 
world 

Parameters: 



- Allows the process to modify privileges of 
processes with the same owner id and group id (uic) 
as the calling process. 

- Allows the process to modify privileges of 
processes with the same group id as the calling 
process 

- Allows the process to assign new privileges 
to processes which it can affect 

- Allows the process to modify privileges of 
any process in the system 



pid - A long word containing the process id of the 

process whose privileges are to be changed. A 
pid of represents the current process. A pid 
of -1 represents the parent of the current process. 

priv - A long word containing the privilege mask, a bit 

mask of privileges to be given to the specified process, 

If the value of this parameter is -1, the 

specified process is given the same privileges 

as the calling process. If the value of this 

parameter is not -1, it represents privileges 

which are bit encoded as follows: 

Bit Name Bit Description 



pcbpvsetpriv 
pcbpvsystem 1 
pcbpvreadphys 2 
pcbpvwritephys 3 
pcbpvsetprior 4 
pcbpvchngsuper 5 
pcbpvbypass 6 
pcbpvoperator 7 



setpriv 

system 

readphys 

writephys 

setprior 

chngsuper 

bypass 

operator 
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pcbpvaltuic 

pcbpvworld 

pcbpvgroup 

pcbpvnetwork 

pcbpvsetattr 


8 

9 
10 
11 
12 
13- 


32 


altuic 
world 
group 
network 
setattr 
Reserved. 



status 



Diagnostics : 



Must be set to zero 
Address of a long word to receive the result of 
the operation. 



errinsufpriv 
errprcsnotfnd 



The process lacks the privileges required 
perform the operation. 
The specified process is not in the system 
process table. 



to 



See Also: 



_getprv - Get process privilege 
_settmsl - Change scheduling time slice 



Assembler Calling Sequence: 

push pid 

push priv 

push status 

jsr _setprv 

C Function Declaration: 



long 
_setprv(pid, priv) 

long pid; 

long priv; 

FORTRAN Subroutine Declaration: 



; value - process id 
; value - new privilege mask 
;address - result of the operation 
;set process privilege 



/* set process privilege */ 

/* returns result of the operation */ 

/* process id */ 

/* new privilege mask */ 



subroutine _setprv(pid, 
integer *4 pid 
integer *4 priv 
integer*4 status 



! set process privilege 
priv, status) 
! process id 
I new privilege mask 
i result of the operation 
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Pascal Procedure Declaration: 



procedure _setprv( {** set process privilege) 

pid : longint; {** process id) 

priv : longint; {** new privilege mask) 

var status : longint {** result of the operation) 

) ; external ; 
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_SETRTM 
Set/clear real time mode flag. 

Description: 

Allows a process with setprior privilege to 

set or clear the realtime mode flag in the process 

control block of the current process. If the real 

time bit is set, context switches to the next process 

will not occur until the process voluntarily relinquishes 

control. Note that doing an I/O operation that requires 

the process to wait until the I/O is complete will also 

cause the process to relinquish control. The time slice 

interrupt clock is ineffectual for a process in real-time mode. 

Related Privileges: 

none - Allows the calling process to clear the realtime 

mode flag. Note that this is not especially useful 
unless the process can also set the realtime mode flag. 

setprior - Allows the calling process to set or clear the 
realtime mode flag. 

Parameters: 

mode - A long word containing the realtime mode flag. A 

value of will clear the realtime mode flag. Non-zero 
values set the flag. 

status - Address of a long word to receive the result of 
the operation. 

Diagnostics : 

errinsufpriv (1) The process lacks the privileges required to 

perform the operation. 

See Also: 

__prirat - Set the priority scheduling ratio 

setpri - Set process's priority 
_settmsl - Change scheduling time slice 

Assembler Calling Sequence: 

push mode ;value - real time flag 

push status ;address - result of the operation 

jsr setrtm ;set/clear real time mode flag 

C function declaration: 
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/* set/clear real time mode flag */ 

long /* returns result of the operation */ 
_setrtm(mode) 

long mode; /* real time flag */ 

Fortran Subroutine Declaration: 

c ! set/clear real time mode flag 
subroutine setrtm(mode, status) 

integer*A mode ! real time flag 

integer*4 status ! result of the operation 

Pascal Procedure Declaration: 

procedure setrtm( {** set/clear real time mode flag} 

mode : longint; {** real time flag} 

var status : longint {** result of the operation} 
) ; external ; 
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_SETRTR 
Assign devicenames to a rotor list. 

Description: 

This call is used to define a rotor list. A rotor list is a list of 
devices which share a set of generic characteristics. The term 
"rotor" is derived from the telephone industry, where a set of 
telephone lines is assigned to a customer. Although each line has a 
specific telephone number assignment, any available line may be used 
by dialing the number of the first line in the rotor group. Upon 
receipt of an incoming call to a number in the rotor group (which is 
actually a request to use a free line in the rotor group) the 
telephone company automatically searches for a free line and either 
assigns it to the incoming phone call or, should there be no free 
lines, returns an error signal to the caller (a busy signal) . 

Rotor lists are useful under WMCS when a group of similar devices is 
provided as a pool of resources, such as a set of modem lines, a set 
of identical printer lines, etc. An example may be a situation where 
several modem lines are available for outgoing calls on a system. 
Rather than writing device specific software or determining status on 
each modem line before attempting to use it, the system manager may 
wish to place all outgoing modem lines together in a rotor list. The 
software can then call the alloc system call using the rotor list 
name as its argument. If any modem line is free (and the specified 
process has appropriate access to it) , the line will be reserved for 
the specified process and the name of the specific device will be 
returned to the calling process. 

The first name provided in the input list is used as the rotor list 
name. This name may be up to 93 characters and will be logically 
translated before devices are assigned to it. Only the first 8 
significant characters of the logical name translation will be 
retained by WMCS. The devicenames follow the rotor list name and are 
separated from the rotor list name and from each other by commas. The 
devicenames to be inserted into the rotor name list are logically 
translated before they are used. Imbedded spaces are illegal. If the 
first name in the list (the rotor list name) is found to already 
exist, the previous list is discarded and the new list takes its 
place. A rotor list may be deleted by setting the rotor list name to 
have no list elements. 
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Related Privileges: 

none - The process cannot assign a list of devicenames to a 

rotor list, 
operator - Allows assignment of a list of devicenames to a rotor 

list. 



Parameters: 
rtrnam 
rtrlst 



status 



Address of a null terminated string identifying the 
rotor list name. 

Address of a null terminated string identifying the 
devices which are to be assigned to the rotor list. Each 
name in the string is separated from the others by a 
comma. Each name in the string will be translated 
automatically by WMCS into its logical equivalent. Each 
element in this list may contain up to 93 significant 
characters but must translate to a name of not more than 
8 characters. 

Address of a long word to receive the result of the 
operation. 



Diagnostics : 

errinsufpriv (1) 

errnomemavail (7) 

errnamenull (80) 

errnoname (82) 

See Also: 



The process lacks the privileges required to 

perform the operation. 

All available memory has been allocated. 

The specified name must not be null. 

The specified name does not exist. 



_alloc - Allocate an available device 
jdealloc - Deallocate an allocated device 
.getalc - Get names of allocated devices 
jgetrel - Get names of rotor list elements 
_getrtr - Get rotor list names 



Assembler Calling Sequence: 



push 
push 
push 
jsr 



rtrnam 
rtrlst 
status 
_setrtr 



; address - name of rotor 
;address - name of rotor devices 
; address - result of the operation 
; assign devicenames to a rotor list 
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C Function Declaration: 



long 

_setrtr (rtrnam, rtrlst) 

char rtrnam[1024] ; 

char rtrlst [1024]; 

long index; 

FORTOAN Subroutine Declaration: 



/* assign devicenames to rotor list */ 
/* returns result of the operation */ 

/* name of rotor */ 

/* name of rotor devices */ 

/* index into table */ 



! assign devicenames to a rotor list 
subroutine _setrtr( rtrnam, rtrlst, status) 
character *1024 rtrnam ! name of rotor 
character *1024 rtrlst ! name of rotor devices 
integer*4 status ! result of the operation 



Pascal Procedure Declaration: 

procedure _setrtr( 

rtrnam : string [1024] ; 

rtrlst : string [1024] ; 
var status : longint 
) ; external ; 



{** assign devicenames to rotor list) 

{** name of rotor) 

{** name of rotor devices) 

{** result of the operation) 
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_SETTIM 

Set system date and time. 

Description: 

Allows a process with OPERATOR privilege to set the system 
time-of-day clock. The time is specified in 8 bytes. 
Those fields of the time that exceed the maximum value for 
that field are truncated. The format of the date and time 
within these 8 bytes is as follows, where byte is the most 
significant byte. 

Bytes Description 

0,1 The current year (counted from A.D. 0). Example, 1983. 

2,3 The day of the year (1..365 or 1..366) 

4 The hour of the day (0..23) 

5 The minute of the hour (0..59) 

6 The second of the minute (0..59) 

7 The fraction of a second (in lOOths of a second) (0..99) 

Related Privileges: 

none - Process not allowed to set the date and time 

operator - Allows process to successfully set the system 
clock 

Parameters : 

siteid - A long word containing the system id of the system 

whose clock is to be set. A siteid of zero corresponds 
to the system on which the calling process is executing. 

mstirae - Most significant 32 bits of the clock in system 
time format. Contains the year and day portions 
of the clock. 

lstime - Least significant 32 bits of the clock in system 
time format. Contains the hour, minute, second 
and fraction of a second portion of the clock. 

status - Address of a long word to receive the result of 
the operation. 

Diagnostics : 

errinsufpriv (1) The process lacks the privileges required to 

perform the operation, 
errinvsiteid (8) The specified site id does not exist. 

See Also: 

__gettic - Get internal tick count 
gettim - Get the current date and time 
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Assembler Calling Sequence: 



push 


siteid 


push 


mstime 


push 


lstime 


push 


status 


jsr 


settim 



;value - system id 

;value - day and year 

;value - hour, minute, second, tick 

jaddress - result of the operation 

;set system date and time 



C function declaration: 



long 

_settim(siteid, mstime, lstime) 

long siteid; 

long mstime; 

long lstime; 

Fortran Subroutine Declaration: 



/* set system date and time */ 

/* returns result of the operation */ 

/* system id */ 

/* day and year */ 

/* hour, minute, second, tick */ 



! set system date and time 
subroutine settim(siteid, mstime, lstime, status) 
integer*4 siteid ! system id 
integer*4 mstime ! day and year 
integer*4 lstime ! hour, minute, second, tick 
integer*4 status ! result of the operation 



Pascal Procedure Declaration: 



procedure __settim( 

siteid : longint; 

mstime : longint; 

lstime : longint; 
var status : longint 
) ; external; 



{** set system date and time} 

{** system id} 

{** day and year} 

{** hour, minute, second and tick} 

{** result of the operation} 
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_SETTMSL 
Change scheduling time slice. 
Description: 

Change the scheduling time slice of a process. Time slice 

is the maximum amount of time the non-real time process will 
be allowed to execute each time it is scheduled. When the 

time slice is expired, other processes are allowed to execute 
according to the scheduling algorithm. 

Each time slice increment is .01 milliseconds. A time slice 
value of 5000 allows the process to execute up to one twentieth 
of a second (50 milliseconds) each time it is scheduled. A time 
slice value less than 10 results in the process not running at all 

Note that processes will not always use their full time slice. 
When an I/O operation is performed, the process often relinquishes 
control and loses the rest of its time slice. 

Any process can lower the time slice of all processes that 

it can affect, setprior privilege is required to increase the 

time slice value of any process. 

Related Privileges: 



None 



group 

world 
setprior 



- Allows affecting the time slice of any process with 
the same owner id and group id (uic) as the calling 
process. 

- Allows affecting the time slice of any process with 
the same group id as the calling process. 

- Allows affecting the time slice of any process whatsoever. 

- Allows increasing the time slice of any process which 
the current process can affect. 



Parameters: 
pid 



- A long word containing the process id of the process 
whose time slice is to be changed. represents 
the current process; -1 ($FFFFFFFF) represents the 
parent of the current process. 

tslice - A long word containing the new time slice value (0.. 65535) 
A long word value of -1 ($FFFFFFFF) is a keyword value 
that means to use the same time slice as the calling 
process . 

status - Address of a long word to receive the result of 
the operation. 



Diagnostics : 
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errinsufpriv (1) The process lacks the privileges required to 

perform the operation, 
errprcsnotfnd (2) The specified process is not in the system 

process table. 

See Also: 

_prirat - Set priority scheduling ratio 
setpri - change process's priority 



Assembler Calling Sequence: 



push 


pid 


push 


tslice 


push 


status 


jsr 


settmsl 



C function declaration: 

long 

__settmsl(pid, tslice) 

long pid; 
long tslice; 

Fortran Subroutine Declaration: 

c 



;value - process id 

jvalue - new time slice 

jaddress - result of the operation 

jchange scheduling time slice 



/* change scheduling time slice */ 
/* returns result of the operation */ 



/* process id */ 

/* new time slice */ 



! change scheduling time slice 
subroutine settms(pid, tslice, status) 



integer*4 pid 
integer*4 tslice 
integer*A status 

Pascal Procedure Declaration: 

procedure _settmsl( 

pid : longint; 
tslice : longint; 
var status : longint 
) ; external; 



! process id 

! new time slice 

! result of the operation 



{** change scheduling time slice} 

{** process id} 

{** new time slice} 

{** result of the operation} 
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settrp 



settrp - Initialize a user defined trap. 

Description: 

A "trap" is a software invoked interrupt. It can be fatal 
or non-fatal. Traps caused by attempting to execute privileged 
instructions in user mode, illegal instructions, address traps, 
and bus traps are fatal traps. When a fatal trap occurs, the OS 
deletes the process that caused it. 

Non-fatal traps include the sixteen TRAP instructions, the CHK, 
TRAPV, and emulation instructions, and the divide by zero trap. 

When a non-fatal trap occurs, the OS checks for a "user defined" 
trap handler. If there is one, control transfers to this trap 
handler where the process is allowed to handle the condition 
which caused the trap. The trap handler is execute in the same 
processor mode (user or supervisor mode) as the mode from which 
the trap handler was defined or was executed, which ever is 
higher. The return address and status register will be on the 
top of the stack when the trap handling routine is entered. Use 
the 'RER 1 or 'RTE' instruction to return from a user defined trap. 

If no trap handler has been defined, the OS treats it as a 
fatal error and terminates the process. 

This system service routine allows a user process to define its 
own trap handling routines which can be used to handle non-fatal 
trap conditions. 

Related Privileges: 

None - 

Parameters : 

trap - The number of the trap for which a handler 

is being defined. Traps and 1 are reserved for 

use by the OS. They may not be redefined. Traps 

14 and 15 are reserved for the OS debugger. The 1010 

emulation handler is used by some languages for floating 

point- Redefining the 1010 emulation disables the 

OS floating point support. The valid trap numbers are: 

Trap # Description 
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1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 

21 

22 



23 



Reserved. (TRAP 0) 

Reserved. (TRAP 1) 

Corresponds to the "TRAP 2" 

Corresponds to the "TRAP 3" 

Corresponds to the "TRAP 4" 

Corresponds to the "TRAP 5" 

Corresponds to the "TRAP 6" 

Corresponds to the "TRAP 7" 

Corresponds to the "TRAP 8" 

Corresponds to the "TRAP 9" 

Corresponds to the "TRAP 10" 

Corresponds to the "TRAP 11" 

Corresponds to the "TRAP 12" 

Corresponds to the "TRAP 13" 

Reserved. (TRAP 14) 

Reserved. (TRAP 15) 

Divide by zero trap number 

Bounds checking trap (CHK instruction) 

Check overflow trap (TRAPV instruction) 

Trace trap 

1010 instruction emulation 

1111 instruction emulation 

Exit handler trap handler. A call to SETEXIT 

go to this handler instead of defining a new 

exit handler. 

Floating point interrupt trap handler. 



instruction 
instruction 
instruction 
instruction 
instruction 
instruction 
instruction 
instruction 
instruction 
instruction 
instruction 
instruction 



All other values reserved. 



adr - The address of the trap handler routine. The entry 
point to which control should be transferred when 
the trap occurs. A zero in this parameter means that 
the trap is not to be handled by the user. That is, 
specifying zero for this parameter "undefines" the 
trap. Note that this address must be 
in the user process area ($000000 through $1FFFFF) . 

status - Address of a long word to receive the result of 
the operation. 



Diagnostics : 

errbadtrapnum (15) 



Trap number (during __SETTRAP) exceeds range of 
specifiable numbers. 



See Alsp: 




None. 




Assembler Calling Sequence: 


push 
push 


trap 
adr 



; value - trap number 

; value - address of handler routine 
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push status 
jsr _settrp 

C function declaration: 



long 
_settrp(trap, adr) 

long trap; 

long adr; 

Fortran Subroutine Declaration: 



; address - result of the operation 
; initialize a user defined trap 



/* initialize a user defined trap */ 
/* returns result of the operation */ 

/* trap number */ 

/* address of handler routine */ 



1 initialize a user defined trap 
subroutine settrp (trap, adr, status) 

! trap number 

! address of handler routine 

! result of the operation 



integer*4 trap 
external adr 
integer*4 status 



Pascal Procedure Declaration: 

procedure settrp ( 

trap : longint; 

adr : longint; 

var status : longint 
}; external; 



{** initialize a user defined trap} 
{** trap number} 
{** address of handler routine} 
{** result of the operation} 
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Set process UIC. 

Description: 

Allows a process to set its own user identification code (uic) or 
the uic of another process. The calling process must have operator 
privilege to affect the uic. 

No check is made that the resulting uic belongs to a user with 
an account in the user authorization file. 

Related Privileges: 

None - The calling process can not change the uic on any 

process, 
operator - If the calling process also has group or world privilege 

it can affect the uic of processes as described below, 
group - If the calling process has operator privilege it can 

change the owner id portion of the uic of any process 

with the same group id. 
world - If the calling process has operator privilege it can 

change the uic of any process in the system to any 

value whatsoever. (A value of zero is not allowed) 

Parameters: 

pid - A long word containing the process ID (pid) of 

the process whose uic is to be changed. refers 
to the calling process, -1 refers to the parent 
of the calling process. 

uic - A long word containing the uic that the specified 
process will receive. The most significant word 
(16 bits) of this parameter correspond to the 
owner id and the least significant word corresponds 
to the group id. 

A long word -1 ($FFFFFFFF) is a reserved value that 
means to use the default uic, i.e. the uic of the 
calling process. 

A value of zero for this parameter is not allowed. 

status - Address of a long word to receive the result of 
the operation. 



Diagnostics : 

errinsufpriv 
errprcsnotfnd 



(1) The process lacks the privileges required to 
perform the operation. 

(2) The specified process is not in the system 
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process table. 
See Also: 

_getpcb - Get Process Control Block 
Assembler Calling Sequence: 



push 


pid 


push 


uic 


push 


status 


jsr 


setuic 



;value - process id 

;value - new uic 

;address - result of the operation 

;Set process uic 



C function declaration: 



/* set process uic */ 

long /* returns result of the operation */ 
__setuic(pid, uic) 

long pid; /* process id */ 

long uic; /* new uic */ 

Fortran Subroutine Declaration: 

c ! set process uic 
subroutine setuic(pid, uic, status) 

integer*4 pid ! process id 

integer*4 uic ! new uic 

integer*4 status ! result of the operation 

Pascal Procedure Declaration: 

procedure setuic( {** set process uic} 

pid : longint; {** process id} 

uic : longint; {** new uic} 

var status : longint {** result of the operation} 
) ; external; 
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shrmem 



shrmem - Share a named shared memory area. 

Description: 

A process uses _shrmem to initiate memory sharing using named 
sharable memory areas. Named sharable memory areas are sections 
of system memory which have an associated name- Using this name, 
a process may request that this section of memory be mapped into 
its logical memory space which extends from address $00001000 
through address $001fefff . The size of these memory areas will 
be some multiple of the hardware page size which is 4K bytes. 

To successfully share a named memory area the process must have 
read and/or write privilege to the named memory area. 

Related Privileges: 



none 
altuic 

bypass 
system 

Parameters : 
mname 



adr 



size 



- Allows a process to share a named memory area if the 
process has read and/or write privilege to the named 
memory area. 

- Allows the process to share a named memory area if 
the owner of the process's image file has read and/or 
write privilege to the named memory area. 

- Allows the process to share a named memory area 
regardless of the memory protection mask. 

- Allows the process to share a named memory area if 
the system has read/write privilege to the named 
memory area. 



Address of a null terminated string identifying 
the specific memory area. This string will be 
translated automatical ly by WMCS into its 
logical equivalent. This string may contain up 
to 93 significant characters followed by a null. 
A long word address within the user logical 
address space where the shared area is to appear. 
It is an error to give an address which does not 
begin on a hardware page boundary. It is an error 
if memory is already allocated at this location. 
A long word containing the number of bytes of 
memory to be shared. It is not an error if SIZE 
is not an even multiple of the hardware page size. 
The size parameter may also be less the defined 
size of the named memory area. 
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retlen 



mode 



timout 



status 



- Address of a long word to receive the number of 
bytes actually allocated. If SIZE is greater 
or equal to the size of the shared memory area, 
then the size of the the shared memory area is 
returned. Otherwise, if SIZE is sufficiently 
large that at least one hardware page can be shared 
then SIZE is returned and an warning is given. If 
nothing can be shared, an error is returned. 

It is an error to already have memory allocated 
in the logical space where the shared memory area 
is to reside. 

- A long word which specifies the desired useage 
of the area: read, write, or execute. There is 

no hardware facility for enforcing the distinction 
between read and execute privileges. Protection of 
the memory area is enforced as in the file system. 
Bit Name Bit * Description 
opreadacc read access - requests 

permission for read access to 
the named shared memory 
opwriteacc 1 write access - requests 

permission for write access to 
the named shared memory 

- A long word which specifies an. amount of time the 
process can wait for the shared memory area to 
appear. If the memory area specified by mname is 
not defined before the expiration of timout, an 
error condition exists. 

- Address of a long word to receive the result of 
the operation. 



iagnostics : 




errinvadr 


( 4) 


errmemalloc 


( 5) 


errsizovfl 


( 60) 


errnoname 


( 82) 


errtimeout 


(128) 


errnoreadpriv 


(144) 


errnowritepriv 


(145) 



The memory address is not on a 4K page boundary. 
The process requested a logical page that was 

was already allocated. 
The size passed to WMCS is out of range. 
The name specified does not exist. 
A request was not completed within the 

specified time. 
The process does not have read privilege for 

the file. 
The process does not have write privilege for 

the file. 



See Also: 



__defmem 
_udefmem 
__ushrmem 
_getmlst 



Define a named sharable memory area. 
Undef ine a named sharable memory area. 
Unshare a named sharable memory area. 
Get a list of named sharable memory areas. 
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_setmuic - Change owner of a named sharable memory area. 
_setmprt - Change protection of a named sharable memory area. 



Assembler Calling Sequence: 



push 
push 
push 
push 
push 
push 
push 
jsr 



mname 

adr 

size 

retlen 

mode 

timout 

status 

_shrmem 



address - name of memory area 
value - address of memory area 
value - size of memory area 
address - amount actually shared 
value - access mode (read, write] 
value - time out 
address - result of the operation- 
Share a named shared memory area. 



C Function Declaration: 



long 

_shrmem (mname. adr/ 
char mname [94] ; 
long adr; 
long size; 
long *retl en; 
long mode; 
long timout; 

FORERAN Subroutine Declaration: 



/* share a named shared memory area */ 
/* returns result of the operation */ 
size, retlen, mode, timout) 
/* name of memory area */ 

address of memory area */ 

size of memory area */ 

amount actual Iv shared 



/* 
/* 
/* 
/* 
/* 



access mode 
time out */ 



V 

(read,, write) */ 



subroutine shrmem (mname 
& status) 

character*94 mname 
integer* 4 adr 
integer*4 size 
integer* 4 retlen 
integer*4 mode 
integer*4 timout 
integer* 4 status 

PASCAL Procedure Declaration: 



procedure shrmem ( 



mname 

adr 

size 

var retlen 
mode 
timout 

var status 
) ; external ; 



■string [93] ; 

longint ; 

longint; 

longint; 

longint; 

longint; 

longint 



! share a named shared memory area 
adr, size, retlen, mode, timout. 

I name of memory area 
! address of memory area 
! size of memory area 
I amount actually shared 
! access mode (read, write) 
! time out 
! result of the ooe ration 



{** share a named shared memory area} 

{** name of memory area } 

{** address of memory area } 

{** size of memory area } 

{** amount actually shared } 

{** access mode (read, write) } 

{** time out } 

{** result of the operation} 
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Return a list of all known site ID numbers. 



Description: 

Return a list of site ID numbers and the total number of site ID 
numbers known in the network. 

Related Privileges: 

None. 

Parameters: 



sidlst 
len 
retlen 
total 

Diagnostics : 

None. 

See Also: 

_getnnam 

_getnsid 

_rnidlst 

rsidlst 



Address of buffer to receive the site IDs known 

about in the network. This buffer must be word aligned. 

Maximum number of site IDs that can be 

contained in the sidlst buffer 

Address of a long word to receive the number 

of site IDs that were written into sidlst. 

Address of a long word to receive the total number of 

site IDs known about in the system. This number may be 

greater that the number returned in retlen. 



Get the name of a node 

Get the site ID of a node 

Get list of remote network IDs 

Get list of site IDs from a remote network 



Assembler Calling Sequence: 



push 
push 
push 
push 
jsr 



sidlst 

len 

retlen 

total 

_sidlst 



; address - siteid buffer 

;value - length of sidlst 

;address - number of siteids returned 

; address - total number of siteids 

;get list of site ids 
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C Function Declaration: 

/* get list of known site ids */ 
void /* no result V 

_sidtst (sidlst, len, retl en, total) 

long *sidlst; /* siteid buffer */ 

long len; /* length of sidlst */ 

long *retlen; /* number of siteids returned */ 

long *total; /* total number of site ids */ 

FORERAN Subroutine Declaration: 

c I get list of known site ids 

subroutine _sidlst (sidlst, len, retlen, total) 
integer *4 sidlst ! siteid buffer 
integer *4 len I length of sidlst 
integer*4 retlen I number of siteids returned 
integer *4 total I total number Of site ids 

Pascal Procedure Declaration: 

procedure _sidlst( {** get list of known site ids} 

sidlst : *array_of__char; {** siteid buffer} 
len : longint; {** length of sidlst} 
var retlen : longint; {** number of siteids returnee) 
vac total : longint {** total number of site ids) 
) ; external ; 
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Set device status with LUN. 

Description: 

Allows a process to modify a device status table. 

The device status is a device class dependent 128 byte table, 
maintained by the device driver for each device. 



It is 



NOTE: The device status table may change with each release of 
the operating system. The current definition is included 
in each release in the file named: /SYSINCL.SYS/ 
DSTMDISP.*. Ihe name of the record included in that file 
is "devicestatus, " i.e., in your program you can declare a 
variable whose type is "devicestatus". 

The device status table is divided into two parts. The first half is 
device independent and is composed of the following fields: 





Length 








Name 


(bytes) 
2 


Description 






dsclassid 


The device class. Valid classes are: 






(Note that these names are defined in 






the devtdisp.* 


files) 






Class Name V 


alue 



Description 




dtclassttyspc 


Character device (ttyspc) 






dtclasstty 


1 


Character device (tty) 






dtclasstapespc 


2 


Tape device (tapespc) 






dtclasstape 


3 


Tape device (tape) 






dtclassdiskspc 


4 


Disk device (diskspc) 






dtclassdisk 


5 


Disk device (disk) 






dtclassnetspc 


6 


Network dev. (networkspc) 






dtclassnet 


7 


Network device (network) 






dtclasspipespc 


8 


Pipe device (pipespc) 






dtclasspipe 


9 


Pipe device (pipe) 






dtclasssyncspc 


10 


BSC device (syncspc) 






dtclasssync 


11 


BCS device (sync) 






dtclassquespc 


12 


Queue device (quespc) 
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dsdriverid 2 

dsblksz 2 

dsharderr 2 

dssofterr 2 

dsreadoper 4 

dswriteoper 4 

dsmaxnumdev 2 

dscurnumdev 2 

dsnumtoretry 2 

dserror reason 4 

dsreserved 32 

dsnexttableptr 4 



dtclassque 13 Queue device (que) 

dtclassnondevspc 14 Non-dev device (nondevspc) 

dtclassnondev 15 Non-dev device (nondev) 

The unique ID number for this device driver 

The block size of the device (e.g. sector 

size) 

The hard error count for the device 

The soft error count for the device 

The number of read operations on this device 

The number of write operations on this device 

Maximum # of devices this driver can handle 

# of mounted devices using this driver 

# of times to retry before reporting an error 
Hardware error code for last error received 
on this device 

Reserved 

Address of next device status table 



The second half of the device status table is device class dependent. 
For TAPE class devices the second half is defined as follows: 





Length 










Name 


(bytes) 


Description 








dstpstatus 


2 


Tape device status. 


A bit encoded word. 






Bit name 


bit 


# 


Description 






dstpready 







Set if device ready 






dstpintpend 


1 




Set if interrupt 
pending 






dstprewinding 


2 




Set if tape rewinding 






dstpbotdetect 


3 




Set if device is at 
physical BOT 






dstpeotdetect 


4 




Set if device is at 
physical EOT 






dstpwriteprot 


5 




Set if tape is write 
protected 


dstpflagsl 


2 


Tape status inf ormatior 


t. A bit encoded word. 






Bit name 


bit 


# 


Description 






dstpdoraw 







0=Read after write 

disabled 

l=Read after write 

enabled 






dstperrintenb 


1 




0=Error interrupts are 

enabled 

l=Error interrupts are 

disabled 
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dstpspeed 



Tape speed. Values are: 



dstpdensity 



dstpspeedl2ips 

dstpspeed25ips 

dstpspeed30ips 

dstpspeed50ips 

dstpspeed90ips 

dstpspeedlOOips 

dstpspeedl25ips 

Tape density. 



dstpreserved 50 
dstpuserfield 8 



dstpdens800bpi 

dstpdensl600bpi 

dstpdens3200bpi 

dstpdens6250bpi 

dstpdens6400bpi 

Reserved 

User defined status 



- Reserved 

1 - 12 ips 
2-25 ips 
3-30 ips 
4-50 ips 
5-90 ips 

6 - 100 ips 

7 - 125 ips 
Values are: 

- Reserved 

- 800 bpi 

- 1600 bpi 

- 3200 bpi 

- 6250 bpi 

- 6400 bpi 



For DISK class devices the second half 
defined as follows: 



of the device status table is 



Name 



dsdkintfac 

dsdkiopbcnt 

dsdknumbsect 

dsdksectrack 

dsdkheads 

dsdkcylinders 

dsdkflagsl 



Length 

(bytes) Description 



2 Disk interleave factor 

2 Number of IOEB's allocated to the drive 

4 The number of sectors on the volume 

2 The number of sectors on a track 

2 The number of heads on the device 

2 The number of cylinders on the volume 

2 Disk status information. A bit encoded word. 
Bit Name Bit # Description 



dsdkdensityl 
dsdkdensity2 1 
dsdkdenssignl e 
dsdkdensdouble 
dsdkdensquad 
dsdkdensreserve 
dsdkdoraw 

dsdkwriteprot ' 



Device density 

00 - Single density 

01 - Double density 

10 - Quad density 

11 - Reserved 

If set, do Read after 

write verify 

If set, Device write 

protected 
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dsdkseekdir 
dsdkseekincr 



dsdkseekdecr 



dsdkcurcyl 2 

dsdkcachesz 2 

dsdkentryname 16 

dsdkreserved 20 

dsdkuserfield 8 



15 Current seek direction 

- Increasing 
cylinder numbers 

1 - Decreasing 
cylinder numbers 

Current cylinder position 

Number of sectors in the disk cache 

Null terminated string containing the name of 

this type of drive 

Reserved 

User Defined status 



For TH class devices the second half of the device status table is 
defined as follows: 

Length 
Name (bytes) Description 



dstymoderegl 



Uart mode register 1. 
encoded as follows: 
Bit Name Bit # 
dstymrlbaudfacl 
dstymrlbaudfac2 1 
dstymrlsyncl 

dstymrlasyncl 

dstymrlasyncl6 

dstymrl async64 

dstymrlcharlenl 2 
dstymrlcharlen2 3 

dstymrldw5bit 

dstymrldw6bit 

dstymrldw7bit 

dstymrldw8bit 
dstymrlparityctrl 4 

dstymrlpardis 

dstymrlparenb 
dstymrlparitytype 5 

dstymrlparodd 

dstymrlparevn 
dstymrl stopbitsl 6 



This byte is bit 

Description 
Baud factor 



00 - 



01 - 



1 x clock 



1 x clock 



sync 

rate 

async 

rate 

async 16 x clock 

rate 

async 64 x clock 



10 - 

11 - 

rate 
Character length 
definition 
00-5 data bits 
01-6 data bits 
10-7 data bits 
11-8 data bits 
Parity control 

- disable parity 

1 - enable parity 
Parity type 

- odd parity 

1 - even parity 
Async mode # of stop 
bits 



SIODST-4 



Dictionary of WMCS System Calls 

_siodst 



dstymodereg2 



dstycmdreg 



dstymrlstopbits2 7 

dstymrlbinv 
dstymrlsbl 
dstymrlsbl5 
dstymrlsb2 
dstymrltransctrl 6 
dstymrlnormal 
dstymrltrans 
dstymrlnumsync 7 
ds tymrl sy ncdoubl e 
dstymrl syncs ingl e 
Uart mode register 2. 
encoded as follows: 
Bit Name Bit # 
dstymr2baudrtl 
dstymr2baudrt2 1 
dstymr2baudrt3 2 
dstymr2baudrt4 3 
dstymr2baud50 
dstymr2baud75 
dstymr2baudll0 
dstymr2baudl345 
dstymr2baudl 50 
dstymr2baud300 
dstymr2baud600 
dstymr2baudl200 
dstymr2baudl800 
dstymr2baud2000 
dstymr2baud2400 
dstymr2baud3600 
dstymr2baud4800 
dstymr2baud7200 
dstymr2baud9600 
dstymr2baudl9200 
dstymr2recvclock 4 
dstymr2 recextclk 
dstymr2 r ecintclk 
dstymr2transclock 5 
dstymr2trnextclk 
dstymr2trnintclk 

6-7 
Uart command register. 
Bit Name Bit # 
dstycrtransctrl 
dstycrtcdis 



Async mode # of stop 

bits 

00 - invalid 

01-1 stop bit 

10 - 1.5 stop bits 

11-2 stop bits 

Sync mode transparent 

- normal 

1 - transparent 
Sync mode # of syncs 

- double sync 

1 - single sync 
Ihis byte is bit 

Description 
The baud rate 
Baud rate continued 
Baud rate continued 
Baud rate continued 

0000 - 50 baud 

0001 - 75 baud 

0010 - 110 baud 

0011 - 134.5 baud 

0100 - 150 baud 

0101 - 300 baud 

0110 - 600 baud 

0111 - 1200 baud 

1000 - 1800 baud 

1001 - 2000 baud 

1010 - 2400 baud 

1011 - 3600 baud 

1100 - 4800 baud 

1101 - 7200 baud 

1110 - 9600 baud 

1111 - 19200 baud 
Receiver clock 

- External clock 

1 - Internal clock 
Transmitter clock 

- External clock 

1 - Internal clock 
Reserved 

Bit encoded. 
Description 
Transmitter control 
- Disable 
transmitter 
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dstytermtype 



dstystatreg 



dstycrtcenb 

dstycrdtr 
dstycrdtrhigh 
dstycrdtrlow 

dstycrrecvcrtl 
dstycrrcdis 
dstycrrcenb 

dstycrforcebrk 
dstycrbrknorm 
dstycrbrkforce 

dstycrsenddle 
dstycrdlenorm 
dstycrdlesend 

dstycr reseter ror 
dstycrnoreset 
dstycr reseter r 

dstycr rts 
dstycr rtshigh 
dstycr rtslow 

dstycropermodel 

dstycr ope rmode2 



dstycromnormal 

dstycromautoecho 

dstycromstripdle 

dstycromlocallp 

dstycromremotelp 
Terminal type definition, 
values for each type of terminal. 
Value Name Value Description 



1 - Enable 
transmitter 
Data terminal ready 

- DTR high 

1 - DTR low 
Receiver control 

- Disable receiver 

1 - Enable receiver 
Async force break 

- normal 

1 - force break 
Sync send DLE 

- normal 

1 - send DLE 
Reset error 

- normal 

1 - reset error 
Request to send 

.- RES high 

1 - RTS low 
Operating mode 
Operating mode 
continued 

00 - Normal operation 

01 - Async autoecho 
01 - Sync strip DLE 

10 - Local loop back 

11 - Remote loop back 
This byte contains 



dstywit 

dsty hydra 

dstyvtlOO 

dstyvt52 

dstyt7000 

dstymg8000 

dstytvi912c 

dstyvisual200 

Uart status register. 

Bit Name Bit # 



0-15 

16-246 

247 

248 

250 

251 

252 

253 

254 

255 



dstysrtransrdy 



User defined types 
Reserved 
WIT terminal 
Hydra terminal 
VT-100 terminal 
VTV52 terminal 
T-7000 terminal 
MG-8000 terminal 
TVI 912 C terminal 
Visual 200 terminal 
Bit encoded. 
Description 

Transmitter buffer 
ready 
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dstypacketterm 



dstyflagsl 



dstysrtranfull 
dstysrtranempty 

dstysrrecvrdy 1 
dsty sr r ecvempty 
dstysrrecvfull 

dstysrdschg 2 
dstysrdsrnormal 
dsty sr ds r change 

dstysrparityerr 3 
dstysrparnormal 
dstysrparerror 



dstysroverrunerr 4 
dstysrovernormal 
dstysrovererror 

dstysrframingerr 5 
dsty sr f r amnormal 
dsty srf rarner ror 

dstysrdcddetect 6 

dstysrdcdhigh 

dstysrdcdlow 
dstysrdsrdetect 7 

dstysrdsrhigh 

dstysrdsrlow 
Holds code for packet 
Value Name Value 



- Transmitter full 

1 - Transmitter empty 
Receiver buffer ready 

- Receiver empty 

1 - Receiver full 
DSR or DCD change 

- Normal 

1 - Change in DSR or 
DCD 

Parity error 

- Normal 

1 - Async parity 
error. Sync parity 
error or DLE received 
Overrun error 

- Normal 

1 - Overrun error 
Framing error 

- Normal 

1 - Async framing 
error. S|ync SYN char. 
DCD Detect 

- DCD high 

1 - DCD low 
DSR Detect 

- DSR high 

1 - DSR low 
termination characters 

Description 



dstyptnoterm 

dstyptallterm 
dstyptcrterm 

Terminal status 
Bit Name 
dstycontrolc 

dstyxonxoff 

dstycontrolx 

dstycontrolz 



Do not terminate 
packet on any control 
characters 

1 Terminate packets on 
all control characters 

2 Terminate packet on 
carriage return <CR> 
character 

information. Bit encoded, 
bit # Description 

Control C enable 
(0 = enabled) 

1 xon xof f enable 
(0 = enabled) 

2 Control X enable 
(0 = enabled) 

3 Control Z enable 
(0 = enabled) 
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dstycontrolo 


4 


Control enable 
(0 = enabled) 






dstytabmap 


5 


Tab map enable 
(1 = enabled) 






dstymask8bit 


6 


Mask 8th bit enable 
(0 = enabled) 






dstycontrolu 


7 


Control U enable 
(0 = enabled) 






dstybroadcast 


8 


Broadcast enable 
(0 = enabled) 






dstyhandshakel 


9 


Handshaking type 






dstyhandshake2 


10 








dstyhsbell 




00 - No handshake, 
send bell 






dstyhssoft 




01 - Software 
handshake 






dstyhshard 




10 - Hardware 
handshake 






dstyhsnone 




11 - No handshake, no 
bell 






dsty duplex 


11 


Full/half duplex 
(0 = full duplex) 






dstymodemctrl 


12 


Modem control enable 
(1 = enabled) 






dstyautobaud 


13 


Auto baud enable 
(1 = enabled) 






dsty remote 


14 


Remote enable 
(1 = enabled) 


dstyinputcnt 


2 


Count of characters 


in input interrupt buffer 


dstyoutptcnt 


2 


Count of characters 


in output interrupt buffer 


dstycolumnpos 


2 


Current column 


position 


dstyinbufsz 


2 


Input buffer size ir 


l bytes 


dstyoutbufsz 


2 


Output buffer i 


size in bytes 


dstywidth 


2 


The width of the given terminal screen 


dstylength 


2 


The length of J 


the given terminal screen 


dstysubreadoper 


4 


Number of sub-read operations 


dstysufcwriteoper 


4 


Number of sub-write 


operations 


dsty reserved 


26 


Reserved 






dstyuserfield 


8 


User defined status 





For PIPE class devices the second half 
defined as follows: 



of the device status table is 
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Name 



Length 

(bytes) Description 



dsppreaderpid 

dsppwriterpid 

dspppipeid 

dsppbuffersz 

dsppbuffercnt 

dsppreserved 

dsppuserfield 



4 Process ID of pending reader 

4 Process ID of pending writer 

4 The pipe's ID 

2 Hie buffer size in bytes 

2 Number of characters in the pipe buffer 

40 Reserved 

8 User defined status 



For SYNC class devices the second half 
defined as follows: 



of the device status table is 



Name 



Length 

(bytes) Description 



dssymoderegl 
dssymodereg2 
dssycmdreg 
dssytermtype 



dssystatreg 

dssynumbsync 
dssyflagsl 



Mode register 1 of the uart (See DSTYMDDERBSl 

for bit definitions) 

Mode register 2 of the uart (See DSTYM0DEREG2 

for bit definitions) 

Command register of the uart (See DSTYCMDREG 

for bit definitions) 

Terminal type definition. A binary value. 

Value Name Value Description 



dssyifcm3741 249 

dssyibm2968 250 

dssyibm2770 251 

dssyibm3276 252 

dssyibm3275 253 

dssyibm2780 254 

dssyibm3780 255 

Status register of uart 

for bit definitions) 

Number of sync characters to write 

Device Status flags. Bit encoded. 

Bit Name Bit # Description 



IBM 3741 terminal 
IBM 2968 terminal 
IBM 2770 terminal 
IBM 3276 terminal 
IBM 3275 terminal 
IBM 2780 RJE 
IBM 3780 RJE 

(See DSTYSTATREG 



dssymultipnt 

dssyebcdic 

dssycrcccitt 



0=point to point 
l=multipoint 
0=ascii line 
l=ebcdic line 
0=crc-16 
l=crc-ccitt 
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dssyinputcnt 2 

dssyoutputcnt 2 

dssyinbufsz 2 

dssyoutbufsz 2 

dssyprevrderr 4 

dssyprevwrerr 4 

dssyprevrdtype 1 



dssynumbtrpad 1 

dssyrecsize 2 

dssyreserved 28 

dssyuserfield 8 



dssyasctoebcw 



dssyebctoascr 



dssytranstbl2 



dssylrc 3 0=crc (on above types) 

l=lrc 

4 0=no translate on 
write 

l=translate ascii to 
ebcdic on write 

5 0=no translate on read 
l=translate ebcdic to 
ascii on read 

6 0=use translate 
table 1 

l=use translate 

table 2 
Number of characters in input interrupt 
buffer 

Number of characters in output interrupt 
buffer 

Input buffer size in bytes 
Output buffer size in bytes 
Error from previous un-verif ied read 
Error from previous no-wait write 
Ttype of previous read 
dssynontran - Non-transparent read 
dssytran - 1 Transparent read 
The number of trailing pads to write 
Used in transparent mode with IIBs 
Reserved 
User defined status 



For NETWORK class devices the second half of the device status table is 
defined as follows: 



Name 


Length 
(bytes) 

2 

1 

53 

8 


Description 


dsnkflags 

dsnkwindowsiz e 
dsnk reserved 
dsnkuserfield 


Device status flags. Bit encoded. 
Bit Name Bit # Description 
dsnkfcyte 0=datagram mode 

l=byte mode 
dsnkmodemctrl 1 0=not enabled 

l=modem Ctrl enabled 
Window size the circuit will use 
Reserved 
User defined status 
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For NCNDEV class devices the second half of the device status table 
is defined as follows: 



Name 



Length 

(bytes) Description 



dsnduserfield 



64 



User defined status 



For QUEUE class devices the second half of the device status table is 
defined as follows: 



Name 



Length 

(bytes) Description 



dsquassocdev 
dsqusenddev 

dsquformname 
dsqunumexec 
dsqucurnumexec 
dsquflags 



9 
9 

10 
2 
2 
2 



dsqulength 

dsquwidth 

dsqunextentry 



A null terminated string containing the name 

of the physical printer device 

A null terminated string containing the name 

of the physical device that control messages 

are to be sent to 

A null terminated string containing the 

current form name 

This is the maximum number of entries that 

can execute concurrently 

This is the number of entries that are 

currently active 

Device Status flags Bit encoded. 

Bit Name Bit # Description 



dsquflupdating 



dsquflqmstay 



dsquflnorestart 



) Currently updating 
queue control file 
L Queue manager process 
will remain running 
even when queue is 
empty 
I When queue is mounted 

it does not restart 
jobs in the queue 
This holds the length of the forms of the 
printer associated with this queue 
This hold sthe width of the forms of the 
printer associated with this queue 
This is the entry number of the next entry to 
be enqued 
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dsqutype 



This contains the type of queue this is. The 

values are: 

Value Name Value Description 



dsqubaseprior 



dsqureserved 
dsquuserfield 



20 
8 



dsqutpprint 1 Print type queue 

dsqutpjob 2 Job entry type queue 

This contains the priority that entries will 

be queued at if they specify the default 

priority 

Reserved 

User defined status 



TO perform a set status operation the process must have write 
privilege to the device and either be the owner of the device 
(matching UICs) or have writephys privilege. 

Related Privileges: 

none - Allows access to the device only if the process 

has write privilege to the device and has the 

same owner id and group id (uic) as the device, 
altuic - Allows the process to access the device if the owner 

of the image file for the current process has access 

to the device as described above, 
bypass - Allows the process to access the device without 

requiring write privilege. The process must still 

either be the owner of the device or have writephys 

privilege, 
system - Allows the process to access the device if the system 

has write privilege to the device as described above. 

(This does not obviate the need for device ownership 

or writephys privilege) . 
writephys - Allows physical access to devices as described above. 

(This does not obviate the need for write privilege) . 



Parameters: 
lun 
dstat 
status 



- Logical unit number (LUN) of a file on the device whose 
status we wish to change. 

- Address of the 128 byte device status table that 

is to be written. This buffer must be word aligned. 

- Address of a long word to receive the result of 
the operation. 
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Diagnostics : 

errinsufpriv (1) The process lacks the privileges required to 

perform the operation, 
errinvlfn (132) The logical unit number does not correspond 

to an open file. 

incorrect, 
errnowritepriv (145) The process does not have Write Privilege for 

the file. 



See Also: 



_getdnam 
__getdst 
_giodst 
-ihysop 

_setdst 



Get device name 

Get device status 

Get device status with LUN 

Perform physical device operation 

Set device status 



Assembler Calling Sequence: 

%%sys$disk/sysincl . sys/dstatdisp. asm 

push lun ;value - logical unit number 

push dstat ; address - device status 

push status ;address - result of the operation 

jsr _jsiodst ;set device status with LUN 

C Function Declaration: 

#include "sys$disk/sysincl . sys/dstatdisp. h" 

/* set device status with LUN */ 

/* returns result of the operation */ 



long 

_siodst(lun, dstat) 

long lun; 

devicestatus dstat; 

FORIRAN Subroutine Declaration: 



/* logical unit number */ 
/* device status */ 



I set device status with LUN 
subroutine _siodst(lun, dstat, status) 

integer*4 lun I logical unit number 
character* (*) dstat ! device status 
integer*4 status ! result of the operation 
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Pascal Procedure Declaration: 

%%sys$disk/sysincl . sys/dstatdisp. pas 

procedure _siodst( (** set device status with LUN} 

lun : longint; {** logical unit number) 
dstat : ~array_of_char; {** device status) 
var status : longint {** result of the operation) 

) ; external ; 
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skip - Position tape 

Description: 

Position a tape to the beginning or end of volume, or 
forward or backward a relative number of file marks. 

To successfully position the tape there must be no open 
files on the tape. Unless the process has bypass privilege, 
it must have read privilege to the device. 

Related Privileges: 

None - Allows positioning if process has access to the 

device as described above, 
bypass - Allows positioning independent of the file protection, 
altuic - Allows positioning if the owner of image file 

for the current process has access to the device 

as described above, 
system . - Allows positioning if the system has access to 

the device as described above. 



Parameters 
dname 



stype 



Address of a null terminated string which 

contains the name of the device to be positioned. 

This string will be translated automatically to 

its logical equivalent by the MCS. This string 

may contain up to 93 valid characters followed 

by a null. 

If this string contains a file designation, the 

devicename portion of the file designation is used for 

this parameter. 

The type of skip to be performed. 



Name 



Value Description 



skipfile 

skipbot 

skipeot 



skip file marks 

skip to beginning of volume 

skip to end of volume 



units 



These names are defined in sysincl.sys/sysequ.asnii 
sysincl.sys/sysequ.h and sysincl.sys/sysequ.pas 

Tilt number of files to skip. Positive values 
skip toward the end of the tape. Negative values 
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skip toward the beginning of the tape. 



For the "skip to end of volume" 
is ignored. 



option this parameter 



For the "skip to beginning of volume", if the units 
parameter is zero, the tape is positioned to the 
physical beginning of tape. If the units parameter is 
non-zero r the tape is positioned one block past the 
beginning of tape, i.e. the tape label is skipped, and 
the tape is positioned at the beginning of the first 
file on the tape. 

nskip - Address of a long word to receive the number of 

files successfully skipped. If the stype parameter 
was "skip to beginning of volume" or "skip to end of 
volume", the value assigned to this parameter will be 
one. 

status - Address of a long word to receive the result of 
the operation. 



Diagnostics : 




errinvdevnam 


(130) 


errundevnam 


(131) 


errnoreadpriv 


(144) 


errinvcloper 


(173) 


errfilopen 


(202) 


errinvskpcmd 


(206) 


See Also: 





The specified devicename is syntactically 

incorrect. 

The MCS does not recognize the devicename. 

Is the device mounted? 

The process does not have Read Privilege for 

the file. 

The operation is inappropriate for the 

device class. 

The operation cannot be performed because a 

tape file is open. 

The specified skip or erase tape-function 

is undefined. 

Device integrity errors 



_getpos - Get the current file position 
_physop - Perform physical device operation 
_setpos - Set the current file position 



Assembler Calling Sequence: 



push 


dname 


push 


stype 


push 


units 


push 


nskip 


push 


status 


jsr 


_skip 



; address - device name 

;value - type of skip 

;value - number to skip 

; address - number actually skipped 

; address - result of the operation 

;position tape 
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C function declaration: 



long 

_Sk ip ( dname . stype , units , nsk ip) 

char dname [ 94] ; 

long stype; 

long units; 

long *nskip; 

Fortran Subroutine Declaration: 



/* position tape */ 

/* returns result of the operation */ 

/* device name */ 

/* type of skip */ 

/* number to skip */ 

/* number actually skipped */ 



! position tape 
subroutine skip (dname- stype , units, nskip, status) 



character*94 dname 
integer *4 stype 
integer* 4 units 
integer* 4 nskip 
integer*4 status 

Pascal Procedure Declaration: 



procedure skip( 
dname 
stype 
units 
var nskip 
var status 
) ; external ; 



string [93] ; 

longint; 

longint; 

longint? 

longint 



device name 

type of skip 

number to skip 

number actually skipped 

result of the operation 



{** position tape} 

{** device name} 

{** type of skip} 

{** number to skip} 

{** number actually skipped} 

{** result of the operation} 
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Send interprocess mail. 

Description: 

Send a message to another process. The message may be 
up to 3952 bytes long. The process to which the message 
is addressed must exist at the time of the transmission. 
The message may consist of any information whatsoever. 

Related Privileges: 

None - Allows sending mail to any process with the 

same owner id and group id (uic) as the calling 
process. 

group - Allows sending mail to any process with the 
same group id as the calling process. 

world - Allows sending mail to any process. 

Parameters: 

pid - Process id of the process which is to receive 

the message, 
buf - Address of the message to be sent, 
buflen - Length of the message expressed in bytes, 
status - Address of a long word to receive the result of 

the operation. 

Diagnostics : 

errinsufpriv (1) The process lacks the privileges required to 

perform the operation, 
errprcsnotfnd (2) The specified process is not in the system 

process table, 
errnomemavail (7) All available memory has been allocated. 

See Also: 

gmail - Receive interprocess mail 

Assembler Calling Sequence: 

push pid ;value - process id 

push buf jaddress - message 

push buflen ;value - message length 

push status jaddress - result of the operation 

jsr smail ;send interprocess mail 

C function declaration: 
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long 

_smail(pid, buf , buflen) 

long pid; 

char *buf ; 

long buflen; 

Fortran Subroutine Declaration: 



/* send interprocess mail */ 

/* returns result of the operation */ 

/* process id */ 

/* message */ 

/* message length */ 



! send interprocess mail 
subroutine smail (pid, buf, buflen, status) 



integer*4 pid 
character*(*) buf 

integer*4 buflen 
integer*4 status 

Pascal Procedure Declaration: 



process id 
message 

message length 

result of the operation 



procedure _smail( 

pid : 

buf : 

buflen : 

var status : 

); external; 



{** send interprocess mail} 
longint ; {** process id} 
~array_of_char ; {** message} 
longint; {** message length} 
longint {** result of the operation} 
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tranpid - Translate another processes logical name. 

Description: 

Given a logical name, return the equivalent. If no 
translation can be found, the equivalent is a copv of the 
original. 

When a translation for a name is found, the equivalent 
string will be translated again until one of the following 
occurs: 

- The equivalent does not translate into anything else. 

- The equivalent is defined in terms of itself, (a recursive 
definition is detected. 

- The equivalent has been translated 16 times. 

This feature allows logical names to be defined in terms of 
other logical names. 

Given a pid, searches the logical name table of the specified 
process. If the name is not found, continues searching in the 
logical name table of the parent of .the specified process* and so 
on with the grandparents until either the name is found or 
there are no other parents. If it is still not found, it will 
search the system logical name table. 

Abbreviations are allowed in logical names. An asterisk (*) in 
the logical name is a marker that indicates the minimum string 
that is a recognized abbreviation of the logical name. For 
example, if the logical name is "PR*IOT", a translation of any 
of the strings "PR", "PRI", "PRIN", or "PRINT" will return the 
equivalence . 

If there is more than one occurrence of a name, the first one 
found is used. (Note that there can be only one instance of a 
given name in a process's logical name table) 

Related Privileges: 

none - Allows* the translation of logical names with the logical 
name table of any process with the same owner id and 
group id (uic) as the calling process. 

group - Allows the translation of logical names with the logical 
name table of any process with the same group id as 
the calling process. 

world - Allows the translation of logical names with the logical 
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name table of any process. 



Parameters : 



pid - A long word containing the process ID of the process 

whose logical name tables are to be used. refers to 
the current process. -1 refers to the parent of the 
current process. 

Iname - Address of a null terminated string containing 

the logical name to be translated. The maximum length 
of this string is 93 significant characters followed 
by a null. If this string is longer than 93 characters, 
the string is truncated , and no attempt is made to 
translate it. 

equiv - Address of a 94 byte buffer to receive the equivalent 
of the logical name. The result will be null 
terminated. The string may contain up to 93 valid 
characters followed by a null. 

status - Address of a long word to receive the result of the 
operation. 



Diagnostics : 

errinsufpriv (1) 
errprcsnotfnd (2) 

See Also: 



The process lacks the privileges required 
to perform the operation- 
The specified process is not in the system 
process table. 



assign - Assign a logical name 
jgassign - Assign a global logical name 
_getglb - Ret reive a global logical name 
_getlog - Retrieve a logical name 
_trans ' - Translate a logical name 



Assembler Calling Sequence: 



push 
push 
push 
push 
jsr 



pid 

lname 

equiv 

status 

__tranpid 



C function declaration: 



long 

_tranpid(pid, lname. equiv) 

long pid; 

char lname [941 ; 



; value - process id 

; address - logical name 

;address - equivalent string 

; address - result of the operation 

; translate another processes logical name 



/* translate another processes logical name 
/* returns result of the operation */ 



/* process id */ 
/* logical name */ 
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char equiv[94] ; 
Fortran Subroutine Declaration: 



/* equivalent string */ 



! translate another processes logical name 
subroutine tranpi(pid, lname* equiv. status) 

1 process id 
! logical name 
I equivalent string 
I result of the operation 



integer*4 pid 
character*94 Iname 
character*94 equiv 
integer* 4 status 



Pascal Procedure Declaration: 



procedure tranpid ( 



pid 
lname 
var equiv 
var status 
) ; external ; 



longint; 
string [93] ; 
string [93] ; 
longint; 



{** translate another processes logical name 

{** process id} 

{** logical name} 

{** equivalent string} 

{** result of the operation} 
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trans - Translate a logical name. 

Description: 

Given a logical name, return the equivalent. If 
no translation can be found, the equivalent is. a 
copy of the original. 

When a translation for a name is found, the equivalent 
string will be translated again until one of the following 
occurs: 

- The equivalent does not translate into anything else. 

- The equivalent is defined in terms of itself, (a recursive 
definition is detected. 

- The equivalent has been translated 16 times. 

This feature allows logical names to be defined in terms 
of other logical names. 

Searches the logical name table of the current process. 
If the name is not found, continues searching in the logical 
name table of the parent of the current process, and so on 
with the grandparents until either the name is found or 
there are no other parents. If it is still not found, it 
will search the global logical name table. 

Abbreviations are allowed in logical names. An asterisk (*) 
in the logical name is a marker that indicates the minimum 
string that is a recognized abbreviation of the logical name. 
For example, if the logical name is "PR*INT", a translation 
of any of the strings "PR", "PRI", "PRIN", or "PRINT" will 
return the equivalence. 

If there is more than one occurrence of a name, the first 
one found is used. (Note that there can be only one instance 
of a given name in a process's logical name table) 

Related Privileges: 

None. 

Parameters : 

Iname - Address of a null terminated string containing 

the logical name to be translated. The maximum length 
of this string is 93 significant characters followed 
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eauiv 



Diagnostics : 

None. 
See Also: 



by a null. If this string is longer than 93 characters, 
the string is truncated , and no attempt is made to 
translate it. 

Address of a 94 byte buffer to receive the equivalent 
of the logical name. The result will be null 
terminated. The string may contain up to 93 valid 
characters followed by a null. 



.assign - Assign a logical name 

.gassign - Assign a global logical name 

jgetglb - Retreive a global logical name 

jgetlog - Retrieve a logical name 

.tranpid - Translate another processes logical name 



Assembler Calling Sequence: 



push 
push 
jsr 



lname 
equiv 
_trans 



C function declaration: 



void 

_trans (lname . equiv) 

char lname [94] ; 

char equiv [94] ; 

Fortran Subroutine Declaration: 



;address - logical name 

; address - equivalent string 

;translate a logical name 



/* translate a logical name */ 
/* no result */ 

/* logical name */ 

/* equivalent string */ 



I translate a logical name 
subroutine trans (lname » equiv) 

character*94 lname ! logical name 
character *94 equiv I equivalent string 



Pascal Procedure Declaration: 

procedure trans ( 

lname : string [93]; 
var equiv : string [93] 
) ; external; 



{** translate a logical name} 

{** logical name} 

{** equivalent string} 
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udefmem - Undef ine a named shared memory area. 

Description: 

Normally, shared memory areas will go away when the last process 
using the memory area has terminated. If the linger bit is set at 
the time that the named shared memory area is defined, then the 
memory area must be explicitly removed using _udefmem. This will 
clear the linger bit and if no one is currently using the area will 
deallocate the memory. If someone is using the memory, a warning 
will be returned and the memory will go away when the last user 
finishes. The process executing this call must have delete privilege 
to the shared memory area or else have Bypass privilege. 

Related Privileges: 

none - Allows deletion of a named shared memory area if 

the process has delete privilege to the named shared 
memory. 

altuic - Allows deletion of a named shared memory area if the 

owner of the process's image file has delete privilege 
. to the named shared memory. 

bypass - Allows the process to delete any named shared memory area. 

operator- Allows the process to delete any named shared memory area. 

Parameters : 



mname 



status 



Address of a null terminated string identifying 
the specific memory area. This string will be 
translated automatically by WMCS into its 
logical equivalent. This string may contain up 
to 93 significant characters followed by a null. 
Address of a long word to receive the result of 
the operation- 



Diagnostics : 



errnoname 
errnodelpriv 



( 82) The name specified does not exist. 
(146) The process does not have delete privilege for 
the file. 



See Also: 



_defmem - Define a named sharable memory area. 
_jshrmem - Share a named sharable memory area. 
_ushrmem - Unshare a named sharable memory area. 
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getmlst - Get a list of named sharable memory areas. 
_setmuic - Chance owner of a named sharable memory area. 
_setnprt - Change protection of a named sharable memory area. 



Assembler Calling Sequence: 



pusn 


mname 


push 


status 


jsr 


_udefmem 



C Function Declaration: 



long 

_ udef mem (mname ) 

char mname [941 ; 

FORERAN Subroutine Declaration: 



; address - name of memory area 

; address - status 

; Undef ine a named shared memory area. 



/* undef ine a named shared memory area */ 
/* returns result of the operation */ 

/* name of memory area */ 



_udef mem (mname. status) 
character*94 mname 
intecer*4 status 



PASCAL Procedure Declaration: 

procedure udef mem ( 

mname : string [93]; 
var status : longint 
) ; external; 



I undef ine a named shared memory area 

I name of memory area 
i result of the operation 



{** undef ine a named shared memory area} 
{** name of memory area} 
{** result of the operation} 
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Unlock a records in an open file. 

Description: 

_unlock is the complement of __lock. Given a valid logical 
unit number (lun) it unlocks the specified records so that 
they can be accessed by processes other than the calling 
process. Any subportion of a lock request can be unlocked. 

When unlocking records the following rules will be applied: 

a) If the entire unlock request is locked by this 
process then it will be successful and a normal 

status will be returned. 

b) If some of the unlock request is locked by this 
process but not all, then those pieces will be 
unlocked but a warning will be returned saying 
it tried to unlock unlocked segments. 

c) If the entire unlock request is not locked by 
this process then an error will be returned 
saying it tried to unlock unlocked segments. 

Records may only be unlocked on disk class devices. 
Related Privileges: 

None. 
Parameters : 



lun 
recnum 



nrecs 



status 



- The logical unit number of the file in which 
records are to be unlocked. 

- A long word containing the starting position 

of the section of the file to be unlocked. The 
first record in the file is record 0. This is 
an unsigned value. A recnum of $FFFFFFFF (-1) is 
a reserved value and corresponds to the current 
file position. 

- A long word containing the number of records to 
be unlocked. If this parameter is zero, it means 
to unlock from the current position to the logical 
end of file. This also is an unsigned value. 

- Address of a long word to receive the result of 
the operation. 



Diagnostics : 
errinvlfn 

errinvcloper 



(132) The logical unit number does not correspond 

to an open file. 
(173) The device class is inappropriate for the 
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unlock 



errksamnorec 
errrlocknotl 

errlockint 



operation. 
(237) The specified record(s) is not locked. 

(253) The process attempted to unlock a record(s) it 
had not locked. 

(254) (MCS error) A discrepency in the Record Locking 
code has been detected. 



See Also: 

_lock 
_read 
write 



- Lock records within an open file 

- Read from an open file 

- Write to an open file 



Assembler Calling Sequence: 



push 


lun 


push 


recnum 


push 


nrecs 


push 


status 


jsr 


unlock 



C function declaration: 



long 

_unlock( lun , recnum , nrecs ) 

long lun; 

long recnum; 

long nrecs; 

Fortran Subroutine Declaration: 



;value - logical unit number 
;value - starting record number 
;value - number of records 
;address - result of the operation 
junlock records in an open file 



/* unlock records in an open file * 
/* returns result of the operation 

/* logical unit number */ 
/* starting record number */ 
/* number of records */ 



! unlock records in an open file 

subroutine unlock(lun, recnum, nrecs, status) 
integer*4 lun ! logical unit number 
integer*4 recnum ! starting record number 
ingeger*4 nrecs ! number of records 
integer*4 status ! result of the operation 



Pascal Procedure Declaration: 

procedure _unlock( 

lun : longint; 

recnum : longint; 

nrecs : longint ; 
var status : longint 
) ; external ; 



{** unlock records in an open file} 

{** logical unit number} 

{** starting record number} 

{** number of records} 

{** result of the operation} 
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ushrmem 



ushrmem - Unshare a named shared memory area. 

Description: 

Associated with each process is a list of the shared memory 
areas which are currently allocated to the process. When an 
area is no longer needed,. _ushrmem is called to decrement the 
reference count of the specified memory area. If the reference 
count becomes zero and the linger bit is not set, then the 
shared memory area will be removed from the system. The process 
cleanup routines will reduce the reference counts for any shared 
memory areas still belonging to the process at the time it 
terminates. 

Related Privileges: 

none 



Parameters : 
mname 



adr 



status 



Address of a null terminated string identifying 
the memory area to be deallocated. This string 
will be translated automatically by VMCS into its 
logical equivalent. This string may contain up 
to 93 significant characters followed by a null. 
A long word containing the location in local user 
logical memory where the shared memory area starts. 
This needs to be specified since the process may 
have the same shared memory area mapped to several 
locations in its memory space. 
Address of a long word to receive the result of 
the operation. 



Diagnostics : 

errinvadr 
errnoname 

See Also: 

_defmem 

_udefmem 

_shrmem 

_getmlst 

_setmuic 

_5etmprt 



4) The memory address is not on a 4K page boundary. 
82) The name specified does not exist. 



Define a named sharable memory area. 

Undef ine a named sharable memory area. 

Share a named sharable memory area. 

Get a list of named sharable memory areas. 

Change owner of a named sharable memory area. 

Change protection of a named sharable memory area. 
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ushrmem 



Assembler Callinq Secuence: 



push 


mname 


push 


adr 


push 


status 


jsr 


_ushrmem 



C Function Declaration: 

long 

jushrmem (mname. adr) 

char mname [941 ; 

long adr; 

FORTRAN Subroutine Declaration: 
c 



; address - name of memory area 
; value - address of memory area 
; address - result of the operation 
; Unshare a named shared memory area. 



/* unshare a named shared memory area */ 
/* returns result of the operation */ 

/* name of memory area */ 
/* address of memory area */ 



! unshare a named shared memory area 
_ushrmem (mname. adr, status) 

character*94 mname I name of memory area 

I address of memory area 
I result of the operation 



integer*4 adr 
inteqer*4 status 



PASCAL Procedure Declaration: 

procedure ushrmem( 

mname : string [93]; 
adr : longint? 
var status : longint 
) ; external; 



{** unshare a named shared memory area} 
{** name of memory area } 
{** address of memory area } 
{** result of the operation} 
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Get the OS version banner. 
Description: 

Returns a null terminated ASCII string which 

contains the OS version number, release date 
and copyright notice. 

Related Privileges: 

None. 

Parameters : 

siteid - A long word containing the system id of the 

system whose version banner is being requested. 
A siteid of zero corresponds to the system on 
which the calling process is executing. 

buf - The address of the user buffer to receive the 
version banner. This buffer must be at least 
81 bytes long. The resulting string will be 
null terminated. 

status - The address of a long word to receive the result 
of the operation. 

Diagnostics : 

errinvsiteid (8) The specified site id does not exist. 
See Also: 

None. 
Assembler Calling Sequence: 



push 


siteid 


push 


buf 


push 


status 


jsr 


version 



;value - system id 

jaddress - user buffer 

jaddress - result of the operation 

;Get the OS version banner 



C function declaration: 



long 

__version( siteid, buf) 

long siteid; 

char buf [81]; 

Fortran Subroutine Declaration 



/* get the OS version banner */ 

/* returns result of the operation */ 

/* system id */ 
/* user buffer */ 
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version 



c ! get the OS version banner 
subroutine versio(siteid, buf , status) 

integer*4 siteid ! system id 

character*81 buf ! user buffer 

integer*4 status ! result of the operation 

Pascal Procedure Declaration: 

procedure _version( {** get the OS version banner} 

siteid : longint; {** system id} 

var buf : string[80]; {** User buffer} 

var status : longint {** result of the operation} 

) ; external ; 
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_WAIT 

Pause for a period of time. 

Description: 

Relinquishes control to the operating system until the system clock 
time is greater than or equal to the time parameter passed to the 
routine. If the time parameter passed to the routine is negative, the 
absolute value of the parameter is interpreted as being the number of 
clock ticks to wait until waking the process. If the time parameter 
is positive, it is taken to be a clock time in system format, and 
control is returned to the calling routine when the system clock 
becomes greater or equal to that time. If the time parameter passed 
is zero, control is relinquished for one scheduling cycle. 

System time format is expressed in 8 bytes. The format of these 8 
bytes is as follows: 

Bytes Description 



0,1 The year (counted from A.D. 0) Example: 1985 

2,3 The day of the year (1..365 or 1..366) 

4 The hour of the day (0..23) 

5 The minute of the hour (0..59) 

6 The second of the minute (0..59) 

7 The tick (in lOOths of a second) (0..99) 

Related Privileges: 

None. 
Parameters: 

mstime - The most significant 32 bits of the time parameter. (-1 
is for relative waits, or day and year.) If the value 
of this parameter and the next parameter is zero, the 
process will relinquish control for one scheduling cycle. 

lstime - The least significant 32 bits of the time parameter 

(number of ticks, or hour, minute, second, and tick) . If 
mstime is -1, then the value of this parameter represents 
-1 times the number of "ticks" to wait before rescheduling 
the process, i.e. the number that you enter should be 
negative. 

NOTE: If you are specifying relative time, the two 32-bit 
numbers are treated as one 64-bit number. 



WAIT-1 



Dictionary of WMCS System Calls 
_wait 



Diagnostics : 
None. 



See Also: 

_hibern - Hibernate a process 
Assembler Calling Sequence: 



push 
push 
jsr 



mstime 
lstime 
_wait 



C Function Declaration: 



void 

_wait (mstime, lstime) 

long mstime; 

long lstime; 

FORTRAN Subroutine Declaration: 



; value - day and year 

; value - hour, minute, second, tick 

;pause for a period of time 



/* pause for a period of time */ 
/* no result */ 

/* day and year */ 

/* hour, minute, second, tick */ 



! pause for a period of time 
subroutine _wait (mstime, lstime) 

integer*4 mstime ! day and year 

integer *4 lstime I hour, minute, second, tick 



Pascal Procedure Declaration: 

procedure _wait( 

mstime : longint; 

lstime : longint; 
) ; external ; 



{** pause for a period of time) 
{** most significant time} 
{** least significant time) 



WATF-2 



WAKE 



wake 



wake - Wake a hibernated process. 

Description: 

Zeroes the hibernate count and clears the hibernate status 
bit in the process control block of the specified process. 
In other words the process will be awakened no matter how 
many times it has been hibernated. No error occurs if the 
process being awakened is not hibernating. Note that a 
process cannot wake itself since a hibernating process 
cannot make the call. 

Related Privileges: 



none 
group 
world 
Parameters : 



- Allows waking any process with the same 
owner id and group id as the calling process. 

- Allows waking any process with the same 
group id as the calling process. 

- Allows waking any process. 



pid - Process id of the process to wake up. A process id 
of -1 refers to the parent of the calling process. 

status - Address of a long word to receive the result of 
the operation. 



Diagnostics : 

errinsufpriv 
errprcsnotfnd 

See Also: 



(1) The process lacks the privileges required to 
perform the operation. 

(2) The specified process is not in the syst< 
process table. 



:em 



Jiibern - Hibernate a process 

__wakec - Wake a hibernated process with count 



Assembler Calling Sequence: 



push 


pid 


push 


status 


jsr 


_wake 



; value - process id 

;address - result of the' operation 

;wake a hibernated process 



C function declaration: 
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long 
__wake (pid) 

long pid; 

Fortran Sub routine Declaration: 

c 



/* wake a hibernated process */ 

/* returns result of the operation */ 

/* process id */ 



1 wake a hibernated process 
subroutine wake (pid, status) 

integer*4 pid I process id 

i result of the operation 



integer* 4 status 

Pascal Procedure Declaration: 

procedure wake ( 

pid : longint; 
var status : longint 
) ; external; 



{** wake a hibernated process} 

{** process id} 

{** result of the operation} 
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wakec 



wakec - Wake a hibernated process with count. 

Description: 

Decrements the hibernate count in the process control block 
of the specified process. When the count goes to zero the 
hibernate status bit of the specified process is then cleared. 
In other words the process does not resume execution until 
_wakec is called at least as many times as Jiibern has 
been called. No error occurs if the process being awakened is 
not hibernating. Note that a process cannot wake itself since 
a hibernating process cannot make the call. 

Related Privileges: 

none - Allows waking any process with the same 

owner id and group id as the calling process. 

group - Allows waking any process with the same 
group id as the calling process. 

world - Allows waking any process. 

Parameters : 

pid - Process id of the process to wake up. A process id 
of -1 refers to the parent of the calling process. 

status - Address of a long word to receive the result of 
the operation- 



Diagnostics : 

errinsufpriv (1) 
errprcsnotfnd (2) 



The process lacks the privileges required to 
perform the operation. 

The specified process is not in the system 
process table. 



See Also: 



Jiibern - Hibernate a process 
_wake - Wake a hibernated process 



Assembler Calling Sequence: 



push 
push 
jsr 



pid 
status 
_ wakec 



;value - process id 

; address - result of the operation 

;wake a hibernated process with count 
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C function declaration: 

long 
_wakec (pid) 

long pid; 

Fortran Subroutine Declaration: 

c 



/* wake a hibernated process with count */ 
/* returns result of the operation */ 

/* process id */ 



I wake a hibernated process with count 
subroutine wakec (pid, status! 



integer*4 pid 
integer*4 status 

Pascal Procedure Declaration: 

procedure wakec ( 

pid : longint; 
var status : longint 
) ; external ; 



I process id 

! result of the operation 



{** wake a hibernated process with count} 
{** process id} 
{** result of the operation} 
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_write 

Write to an open file. 

Description: 

Given a valid logical unit number (lun) of a file open for 
write access, transfers one or more records to the file from 
the process's buffer. 

On successful completion, returns the number of compLete 
records actually transferred. This number may be less than the 
number requested if: 

1) the device becomes 'full' 

2) a timeout occurs 

3) a device error occurs 

Related Privileges: 

None. 
Parameters: 

lun - Logical unit number (lun) of the file to be written. 

recnum - The record position in the file at which to write the 
data. The first record in a file is record 0. A 
$FFFFFFFF (-1) in this parameter means to write the 
record at the current file position. Note that 
recnum is an unsigned long word. On devices other 
than disk, the only option is to read from the 
current file position. For instance on tape, if the 
value of the recnum parameter is not -1 (or the 
current record number) , an error is returned. 

edmode - The edit mode to use. This parameter is divided into 
two 16 bit fields. The least significant word 
represents which edit mode processor to use. The 
most significant word contains edit mode flags for 
the processor. 
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_write 



An output edit mode processor is used to filter the 
output stream as it is written to the file. The 
following transformations are defined: 



Name 

emvwriteraw 
data. 



(0). 
emvwriteln 



Ednode Description 

Raw data. No alterations of 

1 Reserved. Must be set to zero 
(0). 

2 Reserved. Must be set to zero 

3 For tty class devices, this 
edit mode will transform all 
line feeds (10) found in the 
data to carriage return (13) 
line feed (10) combinations. On 
all other device classes, this 
edit mode is the same as ednode 
0. 



The most significant word of the edmode parameter 
contains the following bit flags. When the bit is a 
one (1) the following descriptions apply: 



Bit name Bit 

16 
(0). 
emspcompact 17 

emforcectorite 18 



emtransparent 19 



Description 

Reserved. Must be set to zero 

Space compaction - On sync class 
devices spaces are automatically 
compacted. 

Forced write - The data will be 
written all the way to the device 
before control returns to the 
process. All device errors are 
returned. Note that without 
forced write, the data will be 
written only to the device cache 
and device errors will not be 
detected. Forced write results in 
lower performance but better 
error control. 

Transparent mode - On bisync 
class devices causes the data to 
be written in transparent mode. 
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ennowaitwrite 20 



emlockunlock 21 



emitbwrite 



emlinepause 



22 



22 



23-31 



No wait on write - Initiates the 
write and does not suspend the 
calling process waiting for an 
acknowledge. If an error occurs , 
it will be reported on a 
subsequent write. 
Write and unlock - On disk class 
devices, this bit will cause all 
of the records written to be 
unlocked. 

ITS write - On S"XNC class 
devices, if set ITB record 
separators are to be used on this 
write. 

Eause - On TTY class devices, if 
set the write is performed with a 
pause control. The length of 
each screen of output is 
determined by the length 
parameter for the device. This 
pause control works like the 
•.pause switch on many CIP 
commands, i.e., an asterisk 
prompt is displayed after a 
screenful of data is written. 
Striking [SPACE BAR] writes 
another screen, striking [RETEN] 
writes one more line. 
Reserved. Must be set to zero 
(0). 



timout - The wait count is in 100ths of a second and 

represents the amount of time to wait for the 

transfer to complete before timing out. 
buf - The address of the buffer containing the data to be 

written. May be on a word or a byte boundary, 
nrecs - The number of records to write. This parameter is an 

unsigned long word. If it is zero, no data is 

transferred, 
trnsfr - Address of a long word to receive the number of 

records actually written, 
status - Address of a long word to receive the result of the 

operation. 
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Diagnostics : 



errncraemavail 
errtimeout 

errinvlfn 

errreqtolrg 

errnowriteacc 

errinvsecreq 

errno space 

allocated. 

errinveditmd 

errbadpos 

errdeadLock 

errreclocked 

errrlocknotl 

errlockint 



(7) All avail able memory has been allocated. 
(128) A request was not compLeted within the 

specified time. 
(132) The logical unit number does not 

correspond to an open file. 
(137) The request is too large for the system to 

handle. 
(142) The process does not have write-access to 

the specified file. 
(151) The WMCS cannot allocate more than 65535) 

sectors at a time. 
(154) All available disk space, has been 

(189) The WMCS does not recognize the specified 

edit mode. 
(197) The process tried to access a record (on a 

tape) out of sequence. 

(234) The specified record cannot be locked 
without causing a deadlock. 

(235) The specified record(s) are locked by 
another process. 

(253) The process attempted to unlock a 
record (s) it had not locked. 

(254) (WMGS error) A discrepancy in the Record 
Locking code has been detected. 

Device integrity errors 



See Also: 



_create - Create a file 

_getpos - Get the current file psition 

_ lock - Lock records within an open file 

_ppen - Open a file 

_read - Read from an open file 

_setpos - Set the current file position 

^unlock - Unlock records in an open file 



write-4 



Assembler Calling Sequence: 



push 
push 
push 
push 
push 
push 
push 
push 
jsr 



lun 

recnum 

ednode 

timout 

buf 

nrecs 

trnsfr 

status 

_write 



_write 



; value - logical unit number 

;value - record number 

;value - edit mode 

;value - time out 

;address - data to write 

;value - number of records to write 

;address - number actually written 

/address - result of the operation 

;write to an open file 



C function declaration: 



long 
_write 



( lun, recnum r 
long lun; 
long recnum; 
long ednode; 
long timout; 
char *buf; 
long nrecs; 
long *trnsfr; 



/* 

7* 
ednode , 

/* 

/* 
/* 
/* 
/* 
/* 
/* 



write to an open f ile */ 

returns result of the operation */ 

timout, buf, nrecs, trnsfr) 

logical unit number */ 

record number */ 

edit mode */ 

time out */ 

data to write */ 

number of records to write */ 

number actually written */ 



Fortran Subroutine Declaration: 



! write to an open file 
subroutine write (lun, recnum, ednode, timout, 
buf, nrecs, trnsfr, status) 



integer*4 lun 
integer*4 recnum 
integer *4 ednode 
integer*4 timout 
character *(*) buf 
integer *4 nrecs 
integer *4 trnsfr 
integer*4 status 



logical unit number 

record number 

edit mode 

time out 

data to write 

number of records to write 

number actually written 

result of the operation 
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lascal Procedure Declaration: 

procedure _write( {** write to an open file} 

lun : longint; {** logical unit number} 

recnum : longint; {** record number} 

ecmode : longint; {** edit mode} 

timout : longint; {** time out} 
buf : ~array_pf_char; {** data to write} 

nrec : longint; {** number of records to write} 

var trnsfr : longint; {** number actually written} 

var status : longint {** result of the operation} 
) ; external ; 
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_WTPMEM 

Write physical memory. 

Description: 

By default a process can access any memory that is 
part of its own logical address space ($000000 through 
$1FFFFF) To write memory above two megabytes, the 
process must either change to supervisor mode of operation 
or use this call asking MCS to write the memory for it. 

Using _wtpmem to write physical memory has the additional 
property that when memory errors (e.g. attempt to access 
non-existant memory) occur, they are reported to the 
process through the status variable and are not considered 
fatal errors. 

A process must have writephys privilege to write addresses 
in physical memory. 

Related Privileges: 

None - Process not allowed to write physical memory 
writephys - Allows process to write physical memory 

Parameters : 

siteid - A long word containing the system id of the 

system whose physical memory is to be written. 

A siteid of zero corresponds to the system on 

which the calling process is executing, 
adr - Address of the physical memory to be written, 
mode - Specifies whether to use byte, word or long 

word transfers from the specified address. 

indicates byte, 1 indicates word and 2 

indicates long word transfers. All other 

values are reserved and should not be used, 
buf - Address of the user buffer containing the data 

to be written, 
nrec - The number of units (bytes, words or long words) 

to be transferred, 
trnsfr - Address of a long word to receive the number of 

units actually transferred, 
status - Address of a long word to receive the result of 

the operation. 

Diagnostics : 

errinsufpriv (1) The process lacks the privileges required to 

perform the operation. 
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erroddbufaddr 

errbustrap 

errnonexmem 
errmemparity 



(3) The process's buffer does not begin on a word 
boundary. 
(37) The process has a bus error. 

(39) The process attempted to access nonexistent memory 

(40) The process has a memory parity-error. 



See Also: 



push 


siteid 


push 


adr 


push 


mode 


push 


buf 


push 


nrec 


push 


trnsfr 


push 


status 


jsr 


wtpmem 



_chsuper - Change to supervisor mode 
_rdpmem - Read physical memory 

Assembler Calling Sequence: 

;value - system id 
;value - address to write 
;value - byte, word, long word moves 
;address - data to write 
;value - number of units to write 
jaddress - num of units transferred 
jaddress - result of the operation 
_ ;write physical memory 

C function declaration: 

/* write physical memory */ 
long /* returns result of the operation */ 

_wtpmera( siteid, adr, mode, buf, nrec, trnsfr) 

long siteid; /* system id */ 

long adr; /* address to write */ 

long mode; /* byte, word, long word moves */ 

char *buf; /* data to write */ 

long nrec; /* number of units to write */ 

long *trnsfr; /* num of units transferred */ 

Fortran Subroutine Declaration: 

c ! write physical memory 

subroutine wtpmem( siteid, adr, mode, buf, nrec, 



& trnsfr, status) 
integer*4 siteid 
integer*4 adr 
integer*4 mode 
character*(*) buf 
integer*4 nrec 
integer*4 trnsfr 
integer*4 status 

Pascal Procedure Declaration: 

procedure wtpmem ( 

siteid : longint; 



! system id 

! address to write 

! byte, word or long word moves 

! data to write 

! number of units to write 

! num of units transferred 

! result of the operation 



{** write physical memory} 
{** system id} 
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wtpmem 



adr 


: longint; 


mode 


: longint; 


buf 


: "array of char; 


nrec 


: longint; 


var trnsfr 


: longint; 


var status 


: longint 


; external; 





{** address to write} 

{** byte, word, or long word moves} 

{** data to write} 

{** number of units to write} 

{** number of units transferred} 

{** result of the operation} 



WTPMEM-3 



Chapter 4 
Keyed Sequential Access Method (KSAM) 



Keyed Sequential Access Method (KSAM) is a file system that allows fixed 
length data records to be accessed rapidly based upon one or more indices 
or keys found within each data record. 

Depending upon the exact nature and quantity of defined keys, a typical 
KSAM application program can randomly find and access a particular data 
record among many millions and do so with no more than three to five disk 
accesses. Processing data records sequentially (with respect to a 
particular key) typically takes no more than one disk access to load the 
appropriate portion of the key file. 



Features of KSAM 

KSAM has a number of special features: 



1. KSAM is a multi-key , multi-segmented, multi-access file access 
method. 

Multi-key means that you can typically define as many as three 
hundred keys for each record of a file. 

Multi-segmented means that each key can comprise as many as 
fifteen segments. The segments need not be adjacent. 

Multi-access means that many different processes can read 
simultaneously information from a single file. A single 
process with sufficient privilege, however, can lock out other 
users and gain exclusive access to the file. 
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Keyed Sequential Access Method (KSAM) 

2. You can read a file randomly, based upon the value of a key or a 
portion of a key. You can also read the file sequentially 
forward or backward on any key or portion of a key. 

3. KSAM is based upon the B-tree data structure that offers the 
following advantages over similar file access methods: 

KSAM runs on all Motorola MC68000-based WICAT computers. 
Previously, indexed sequential file access methods were 
available only on intermediate-sized mini-systems and larger 
computers. 

The B-tree data structure requires little operator 
maintenance. Algorithms on other indexed sequential file 
access systems often become inefficient as files are 
enlarged or deleted, occasionally requiring the operator to 
rebuild the key structure. 

KSAM is fast. For example, given a file containing 5000 
150-byte records, each with 4-byte keys, records can be read 
randomly at 1000 records per minute, and can be written 
randomly at 500 records per minute. 

KSAM key files are rebuildable. Since data and key 
information reside in separate files, you can easily 
reconstruct the key file from the data file, if the key file 
is ever damaged. 



Calling KSAM 

The various KSAM operations are implemented by system supervisor calls 
(SVCs) . For a general explanation of SVCs, see Chapter 3 of this manual. 
The KSAM SVCs can be called from assembly language and from most of the 
compiled high-level languages that WICAT supports. The calling sequences 
and parameters for each of these routines are described in Chapter 3. 



KSAM as a Class Handler 

KSAM consists of approximately 16 Kbytes of shareable, re-entrant code. 
You may elect to load this code as a class handler when you boot your 
system. 

When WMCS encounters a call to a KSAM SVC and determines that KSAM is 
present, WMCS transfers control to the KSAM class handler. If KSAM is 
absent, WMCS returns an error to the calling process. 
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Memory Requirements 



In addition to the 16 Kbytes for the class handler, KSAM requires four 
Kbytes of memory whenever one or more files are open for KSAM processing. 
Each additional file that is opened requires additional memory to be 
allocated for key file processing. The total amount of memory used 
depends upon the file definition and the options requested by the calling 
process. See the SVC descriptions for .JQOPEN and _£CREAT for details. 



KSAM Pile Structure 

KSAM files are physically composed of a data file containing data records 
and a keys file containing the key information. This composition is for 
two reasons: 

1. The keys may be treated uniformly (internally consistent) when 
data records are segregated. 

2. The keys file may be recreated from the data file if a system 
failure ever damages the keys file. 

With key information separated from data records, you must ensure that 
the data records agree with the key information. Neither WMCS nor KSAM 
knows that a key file has been erroneously paired with a data file or 
that either the key file or the data file has been independently changed 
in relation to its partner. 

NOTE: Should independent changes occur in either file of a paired 
key file and data file, subsequent KSAM operations on the file 
pair may produce unpredictable results and irreparably damage 
the integrity of the data and/or key files. 



Data File 

The data file contains the actual data records, along with a flag 
indicating whether a record is deleted. 

The creating process specifies the length of the data records. The 
data file comprises fixed length data records, and the data records 
must be between 4 and 65334 bytes inclusive. 

Besides the user data, each record contains as its first byte a 
deletion flag. With the deletion flag KSAM can keep track of 
obsolete data record slots. These slots are reused as new data are 
written to the file. 
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This first byte also allows a recovery program to determine whether 
a record in a data file contains valid data. 

A recovery program could use the deletion flag byte to read records 
from a data file, determine their validity, and then reconstruct a 
valid key file fcy writing only valid data records to a new KSAM file 
pair. 

Keys File 

The keys file consists of a number of 1-Kbyte key blocks containing 
information about the keys defined for the KSAM file, the data 
records and the B-trees of the keys. In the keys file, keys are 
stored and organized, and random searches and sequential reads are 
performed. The keys file contains pointers to the data records in 
the data file. 

The key definition area in the keys file contains two kinds of 
information: 

1. Information regarding the type, length, and components of 
each key. 

2. Information regarding obsolete data and key records, the 
number of active and unused data and key records, the depth 
of the KSAM key tree structure, and the location of the root 
node of each key tree. 

Key information used to locate particular records begins after the 
key definition area. 

The structure used is a modified B-tree. Each defined key is 
represented by its own B-tree. The B-trees share the same file. 

The leaf level of the B-trees points into the data file. 

Because each node of the B-tree is 1 kbytes long, the B-tree can 
point to many children nodes. A four-byte key definition would allow 
a fan-out of 125 children at each level. (4-byte key + 4 bytes for 
pointer = 8 bytes; IK/ 8 = ""125) Thus a four-level B-tree could 
provide indices into 125 * 125 * 125 * 125 or over 244 million data 
records. The top level of each B-tree is always kept within the KSAM 
file system. 

You may specify an additional number of key nodes for permanent 
residency- Should only the root node of a four-level B-tree be kept 
in memory, any record of a 244-million record data file could be 
found and accessed with a maximum of four disk accesses. 
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The levels occupied by any B-tree are available via the _KINFO SVC. 
The number of levels provides a useful clue for estimating the 
access time necessary to refer to a data record using that key. 



Pointers 

Each file pair opened using KSAM is assigned three pointers. The user 
process cannot access these pointers. Nonetheless, the pointers tell how 
the key file is manipulated and how the data file is referenced. 

OJRRHSIT KEY POINTER. The current key pointer defines which of the B-trees 
will be used for key comparisons and data file references. 

The current key is defined by default by calls to .JCOPEN and _KCREAT and 
may be changed with calls to _J(MOVBB and _KFIND. 

CURRENT POSITION POINTER. The current position pointer may be thought of 
as always pointing between two data records. 

Records may be read either sequentially forward or backward relative to 
the current position pointer. 

The current position pointer is set by calls to _KCREAT and _£QPEN, and 
may be changed by _JTOVFB, _JCFIND, _j<WRITE, .JCUFDAT, and _KDELET. 

CURRENT RECORD POINTER. The current record pointer points to the last 
record read or written. Thus, it is defined by a successful call to 
_KREAD or _KWRITE. 

Successful calls to _JCOPEN, JKCREAT, _KDELET, _KMOVEB, and _KFIND leave 
the current record pointer undefined as do error returns from a KSAM 
function SVC. 

Ttoo SVCs, _KDELET and _KUEDAT, require that the current record be defined 
before they may be called. _KREAD is the typical choice for defining 
current record to make these calls. 



Current Key 

A current key and a current record exist whenever a KSAM file is 
being read or written. If a key is used in randomly finding a 
record, the key number must be given to KSAM. 

This key number establishes which key becomes the current key. 

If a sequential read is then executed, the next record (or previous 
record, in the case of a backward read) is that whose key 
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alphabetically (numerically for numeric keys) follows (or precedes) 
the key of the current record. 

All operations performed on the file will take place relative 
towards the current key. 

The current key can be changed only by executing a random find of a 
record (_jCFIND) or fcy placing the file at the beginning or end of 
the file CJMOVEB) . 

The current key can become undefined if any of the above mentioned 
calls fails. 



Current Record 

A successful execution of a read (JKREAD) , write (_KWRITE) , or 
update (_JCUEDAT) establishes the current record. The current record 
becomes undefined whenever one of the following five calls is 
performed, or if any of the other calls fail: 

1. A random find (_KFIND) 

2. A position to beginning or end of file (_KMOVFB) 

3. A create CKCREAT) 

4. An open (_KOPEN) 

5. A record delete (.JODELET) 



Keys 



Six distinct kinds of keys are supported. 

1. signed byte (8 bits) 

2. unsigned byte (character) 

3. signed word (16 bits) 

4. unsigned word (16 bits) 

5. signed longword (32 bits) 

6. unsigned longword (32 bits) 



.Size. 



Each key may be up to 255 bytes long. Word and longword keys and 
key segments must lie on word boundaries (even byte) within memory 
and within the data record. Word keys and key segments must be two- 
byte multiples/ and longword keys and key segments must be four-byte 
multiples. Assigning either a byte value in a record definition may 
misalign word or longword key fields that follow. You may have to 
offset the other keys to align them on word or longword boundaries. 
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Key Definitions 



No arbitrary limit exists for the number of keys that may be defined 
for a KSAM file pair. 

The one limiting factor on key definitions is that the sum of key 
definitions may occupy no more than 3500 bytes. 

An average key definition occupying eight bytes would allow for the 
definition of over 400 keys. 

Although all keys must be constructed from data fields within the 
data record, these data fields need not be contiguous. 

Up to 15 noncontiguous segments may be included in the definition of 
any key. 

The same data field may be used in as many keys as desired. 

KSAM allows a key definition to designate that duplicate key values 
be disallowed for a particular key. When duplicate key values are 
detected, KSAM returns an error condition. 



Updating a Record 



Any key may be updated. _KUEDAT allows a data record to be changed , and 
any changed key values are automatically updated. Updating eliminates the 
necessity of deleting an entire record and writing a new one when only 
one or a few of its many keys have changed values. 



Searching for a Key 

Searching is provided on partial as well as complete key values. Should 
less than the complete length of the key be specified for a search using 
_JCFIND, the current position pointer moves to the record containing the 
first occurrence of the key that matches the partial length specified. 

Should no match be possible, the current position pointer is left 
pointing before the record that would immediately follow the specified 
search key in alphabetical or numerical sequence. 

The error return status of _JCFIND indicates whether a match to a 
searched-for key was found or whether the current position pointer could 
be placed only immediately before where the key should be found were it 
present. 
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Locking Records 



LOCKING: Records may be write locked. Limited only by available memory, 
a process may update, write, and delete any number of data records within 
a KSAM file. You need 32 bytes of memory to lock one record. The 
process attempting to update or delete a locked record may specify how 
long it will wait for the record to become unlocked before returning with 
an error. 

UNLOCKING: All locked records are automatically unlocked when the file 
is closed by the process that locked the records. A process may unlock 
specific records or all records that it has previously locked. Because 
the locking information is retained in memory, a system crash does not 
leave a file on disk with records that cannot be unlocked. 

KSAM files are automatically closed upon process deletion. Locked 
records are automatically unlocked on file closing. 



Multiple Processes 

KSAM allows multiple processes to read simultaneously a KSAM file pair 
that has not been read locked to other processes upon open. 

Multiple processes can modify a file, but KSAM coordinates the procedure 
by allowing only one process at a time to modify (using _KWRITE, _KDELET, 
or _JCUEDAT) the files. Thus, such modifications normally have no adverse 
effect on the pointers of other processes also using the files. 

The only exception is that one process may delete a record currently 
pointed to by another process, thus causing the current record pointer of 
the other process to become undefined. 



Information Facility 

To design generic KSAM programs, use the information facility provided in 
KSAM. The _JCINPO SVC provides information regarding the structure and 
current makeup of a previously created file. 

Information available includes number of keys defined, their definitions, 
number of levels in each B-tree, number of currently active and inactive 
data records, number of currently active and inactive key blocks, data 
record size, etc. 
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Heading and Positioning File Pointer 

•Hie data file may be read sequentially in either direction on any key. 

Calls exist that move the current position file pointer to the beginning 
or end of the file based on any key. By using all or part of any key, 
you can find records at random. 

NOTE: Partial keys for integer and longword keys must be multiples 
of two and four bytes respectively. 

Hardware/Software Requirements 



The KSAM routines run on all WICAT computers. The software supports the 
normal disk class handler and an additional class handler that may be 
loaded at boot time. The routines are not disk hardware specific, but 
rely upon other more primitive routines in the disk class handler and 
device driver (s) for actual device accesses. The keys file and data file 
can reside on different devices, but they must reside on the same 
machine. 



KSAM Data File Description 

The KSAM data file is divided into records of between 4 and 65535 user 
accessible bytes inclusive. 

The first byte of every record is reserved for use by the KSAM to 
determine whether a record contains valid data. 

If the rirst byte is 0, the record contains valid data. 

If the first byte contains a 1, the record has been deleted. 

Deleted records are linked using the first user accessible longword as a 
link field. 

The link contains the relative byte address of the beginning of the next 
free record in the file. 

The last deleted record in the file contains a forward pointer of -1. 

If a KSAM data file contained six records, each with 15 user accessible 
bytes and only three of the records contained valid data, the file might 
look like this: 
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Byte address Flag byte Pointer/user data 



$00000000 $01 $00 00 00 30 xx xx xx xx xx xx xx xx xx xx xx 
(This record is deleted, "xx" is leftover user data) 

$00000010 $00 $uu uu uu uu uu uu uu uu uu uu uu uu uu uu uu 
(Valid record; "uu" is user data) 

$00000020 $00 $uu uu uu uu uu uu uu uu uu uu uu uu uu uu uu 
(Valid record; "uu" is user data) 

$00000030 $01 $00 00 00 40 xx xx xx xx xx xx xx xx xx xx xx 
(This record is deleted; "xx" is leftover) 

$00000040 $01 $FF FF FF FF xx xx xx xx xx xx xx xx xx xx xx 
(This record is deleted; "xx" is leftover) 

$00000050 $00 $uu uu uu uu uu uu uu uu uu uu uu uu uu uu uu 
(Valid record; "uu" is user data) 



KSAM Keys File Description 

The KFCB comprises an in-core (memory only) section and a key file (disk) 
section. The following describes the disk section. 

Key File Information 

The key file contains the following information on the keys in the 
KSAM file. The number in the upper left-hand corner is the byte 
offset physically stored in the beginning of the keys file. The 
actual key definitions begin at offset 38. 

- word 

Length of the keys definition area of the file 
2 - word 

Data record length 
4 - longword 

Number of active records in the data file 
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8 - longword 

Number of deleted records in data file 
12 - longword 

Number of active keyblocks in file 
16 - longword 

Number of deleted keyblocks in file 

20 - longword 

Byte address in the data file where the next unallocated data 
record starts (writing to this address causes the data file to 
be extended) . 

24 - longword ^ 

Byte address where last deleted data record starts; this last 
data record should contain a forward pointer to other existing 
deleted data records. A -1 is used as a null pointer. 

28 - longword 

Byte address where the next unallocated keyblock starts; 
writing to this address causes the key file to be extended. 

32 - longword 

Byte address where the last deleted keybock starts; this last 
block should contain a forward pointer to other existing 
deleted keyblocks. A -1 is used as a null pointer. 

36 - word 

Number of keys defined for this KSAM file 

Definitions 

38 - word 

The first portion of the definitions contains a pointer (1 
word/pointer) to the beginning of each key definition. 

40 - word 
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If more than one key is defined/ the offset of the key 
description for key 2 is contained here. Each key description 
offset occupies a successive word in memory; thus, the offset 
of key 3*s description is contained at 42, key 4's at 44, etc. 

The following repeats once for each key beginning at the offset for 
each key as specified above, minus hex 1A or decimal 26. The length 
of these key descriptions depends on the number of segments that 
constitute the key. 

- byte 

The high order byte for this word contains the number of levels 
in the B-tree for this key 

1 - byte 

Bit seven of this word is a flag bit; if set, the flag 
stipulates duplicate keys are disallowed. Bits four through 
six are the key type as described in .JCCREAT call. The low 
order nibble contains the number of segments in this key. 

2 - word 

High byte is reserved. The low byte contains the length of 
this key in bytes. 

4 - word 

This word contains the maximum number of keys of this size that 
will fit into a 1024-byte keynode or leaf keyblock. 

6 - longword 

This longword is the byte pointer to the root node for this key 
within the key file. 

10 - 

The key segment definitions begin here. The segment definition 
consists of the byte offset within a record where a field 
begins and the length of the field in bytes. The pointer is a 
word, and the length is a word. The byte offset ignores the 
flag byte at the beginning of the record, i.e., the first data 
byte has an offset of zero. 

Repeating Structure: The following two-word sequence repeats 
between 1 and 15 times for each key segment (i.e., there can be up 
to 15 segments for each key) . 
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1. First word is the byte address within a data record where 
the segment starts. 

2. Second word is the length of the segment in bytes. 



Definition Area 

The key definition area is null padded and rounded up to a 1024 byte 
boundary so that disk accesses on the key blocks are optimized 
during run time because they will fall on sector boundaries. 

Immediately following the definition area, the node keyblocks and 
leaf keyblocks begin. 



Keyblocks 

The organization of each 1024 byte keyblock depends upon the size of the 
key it holds. 

NODE KEYBLOCK. Each node keyblock contains the following: 

A counter that indicates how many keys are kept in this node. 

A pointer to the byte address in the key file where the parent block 
occurs (the parent of the root node contains a zero at this 
location) . 

A pointer to the byte address in the key file where the left brother 
block occurs. 

A pointer to the byte address in the key file where the right 
brother block occurs. 

NOTE: If no brother occurs , a zero is placed in those pointer 
locations. 

Following the parent and brother pointers is a key structure that is 
repeated for each key value found in the node. 

The first longword is a pointer to the byte address in the key file where 
the keyblock starts that contains keys less than or equal to the key 
value that follows the pointer. 

Byte keys that have an odd length are right null padded. 

Following the last key structure is a longword pointer containing the 
byte address in the key file where the block may be found containing keys 
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higher that those found in the block pointed to by the last key-pointer 
structure in the present node. 

LEAF KEYBLOCK. The leaf keyblock of the KSAM key file is similar to the 
node keyblock. 

However, now a one-to-one correspondence exists between a pointer-key 
structure and a single record in the data file. 

The key portion of the pointer-key structure in a leaf node is the exact 
data contained in the key-field area in the data record. 

The pointer points to the fcyte address (the delete flag byte) of the 
record containing that key value. 

As in the node keyblock, odd length keys are right null padded to an even 
boundary. 

A leaf keyblock can be recognized by the set flag bit in bit 15 of the 
pointer-key structure count found in the first word of the block. 

A leaf keyblock does not have a "greater than" pointer after the last 
pointer-key structure in the block. 



KSAM Sample Program 

The following KSAM program demonstrates how several SVC calls can be used 
to set up a phone list that can be accessed by name, address, city, 
state, zip code, or phone number. 

program record 
integer *4 lun , status 
integer *2 choice 

call getfil(lun) 
100 continue 

call menu 
110 continue 

call gotoxy(17,10) 

write (6,10) * Enter choice: * 

call getchr (choice) 

if ((choice .GE. 97) .AND. (choice .LE. 122)) choice = choice - 32 

if (choice .EQ. 65) then 

call add (lun) 
else if (choice .EQ. 68) then 

call delete (lun) 
else if (choice .EQ. 70) then 

call find (lun) 
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1000 



10 
30 



else if (choice .BQ. 83) then 

call show(lun) 
else if (choice .BQ. 81) then 

goto 1000 
else 

goto 110 
endif 
goto 100 
continue 

call kclose(lun,0, status) 
call clrscr 
format (A) 
format(lx,I5.1) 
end 



subroutine getfil(lun) 

character *94 f name , kf name 

integer *2 ktable(25) 

integer*4 mode, reclen,prot,numbuf ,lun, status 



fname = 'phone.dat 1 
kfname = f phone. key 1 



mode 
numbuf 



= 3 
= 



I allow read & write access 
I use default buffer size 



call kopen ( f name f kf name f mode/ numbuf ,lun, status) 



if (status .NE. 0) 
reclen = 81 
prot = -1 

ktable(l) = 6 



then 



ktable(2) 
ktable(3) 
ktable(4) 
ktable(5) 

ktable(6) 
ktable(7) 
ktable(8) 
ktableO) 

ktable(lO) 
ktable(ll) 
ktable(12) 
ktable(13) 



1 

20 

20 

1 

24 
20 
24 



1 

20 
44 
20 



! record length is 81 bytes 
! use default protection 

I define 6 different keys 

Ichar field, 1 segment, allow duplicates 
!key is 20 bytes long 
! begins in position of record 
ithis segment runs for 20 bytes. 

Ichar field, 1 segment, allow duplicates 
!key is 24 bytes long 
I begins in position 20 of record 
Ithis segment runs for 24 bytes. 

Ichar field, 1 segment, allow duplicates 
Ikey is 20 bytes long 
I begins in position 45 of record 
Ithis segment runs for 20 bytes. 
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ktable(14) 
ktable(15) 
ktable(16) 
ktable(17) 


= 


1 
2 

64 
2 


1 


ktable(18) 
ktable(19) 
ktable(20) 
ktable(21) 


= 


1 
5 

66 
5 


^ 


ktable(22) 
ktable(23) 
ktable(24) 
ktable(25) 


= 


1 

10 
71 
10 




reel en = 81 
prot = -1 
numbuf = 









char field, 1 segment, allow duplicates 
key is 2 bytes long 
begins in position 65 of record 
this segment runs for 2 bytes. 

char field, 1 segment, allow duplicates 
field is 5 bytes long 
begins in position 67 of record 
this segment runs for 5 bytes. 

char field, 1 segment, allow duplicates 
field is 10 bytes long 
begins in position 72 of record 
this segment runs for 10 bytes. 

record length is 81 bytes 
use default protection 
use default buffer size 



call kcreat ( f name, kf name, mode, reclen, prot, numbuf , 
ktable,lun, status) 
endif 
return 
end 



subroutine add dun) 



C 
C 



C 
100 

110 



character 
character *20 
character*2 
character *5 
character*10 
integer*4 



buf *81 ,addres*24 ,name*20 ,city*20 , state*2 

name, city 

state 

zip 

phone 

lun, status 



(buf (1:1) ,name) 
(buf (21:21) ,addres) 
(buf (45:45), city) 
equivalence (buf (65:65) , state) 
equivalence (buf (67:67) ,zip) 
equivalence (buf ( 72 : 72) , phone) 



equivalence 
equivalence 
equivalence 



Name is position 1-20, 
addres is position 21-44, 
city is position 45-64, 
state is position 65-66, 
zip is position 67-71, 
I phone is position 72-81, 
of the record 'buf. 



continue 

write (6,10) ' Enter clientVs name: ' 

read (5,10) name 

continue 

write (6,10) V Enter clientVs address: 

read (5,10) addres 
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120 continue 

write (6,10) * Enter clientVs city: * 
read (5,10) city 

130 continue 

write (6,10) • Enter clientVs state: • 
read (5,10) state 

140 continue 

write (6,10) ' Enter clientVs zip: * 
read (5,10) zip 

150 continue 

write (6,10) ' Enter clientVs phone number (8012246882): • 
read (5,10) phone 

call kwrite(lun,-l,buf, status) 

if (status .ne. 0) write (6,20) status, 1 KWRTTE' 
1000 continue 

return 
10 FORMAT (A) 
20 format (lx, 15, A) 

end 

subroutine delete dun) 
integer *4 lun, status 
integer *2 value 
call kdelet (lun, -1 , status) 

if (status .EQ. 0) then 

write (6,10) ' Record deleted." 
else 

write (6,10) * Error in deleting record. Error = ', status 
endif 

write (6,10) ' Hit any key to continue.' 
call getchr (value) 
10 format (A, 15) 
return 
end 

subroutine find (lun) 

character*81 buf 

character *24 dummy, title (6) 

integer *4 keynum, lengt , lun, status , index 

integer*2 length(6) ,choice, value 

data length/ 20, 24, 20, 2, 5, 10/ 

data title / 'name',' address 1 /city 1 ,' state 1 , 'ZlPVphoneV 
100 continue 

call fdmenu 
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110 



200 



1000 

10 

20 



continue 

call gotoxy(13,10) 

write (6,10) ' Enter Choice: ' 

call getchr (choice) 

if ((choice .GE. 97) .AND. (choice .LE. 122)) choice = choice - 32 
if (choice .EQ. 78) then 



Search by name. 
Search by address. 
Search by city. 
Search by state. 
Search by ZIP. 
Search by phone. 

Get next occurrence. 



index = 1 
else if (choice .EQ. 65) then 

index = 2 
else if (choice .EQ. 67) then 

index = 3 
else if (choice .EQ. 83) then 

index = 4 
else if (choice .EQ. 90) then 

index = 5 
else if (choice .EQ. 80) then 

index = 6 
else if (choice .EQ. 70) then 

write (6,10) ' « 

goto 200 
else if (choice .EQ. 81) then 

goto 1000 
else 

goto 110 
endif 

keynum = index - 1 

call trim (title (index) , title (index) ,lengt) 

write (6,10) * Enter ', title (index) (lrlengt) ,' to search for: ' 
read (5,10) dummy 

call trim (dummy, dummy, lengt) 

call kf inddun, keynum, dummy (l:lengt) , lengt, status) 

continue 

call kread(lun,l,-l,buf, status) 

if (status .NE. 140) then 

call output (buf) 
else 

write (6,20) ' Error in reading record. Error = ', status 
endif 

write (6,10) ' Touch any key to continue.' 

call getchr (value) 
goto 100 
continue 
format (5A) 
f ormat ( lx , A, 5x , 15 ) 
return 
end 
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subroutine show(lun) 

character *81 buf 

integer *4 keynum, lun , status , count 

integer *2 choice , val ue 

100 continue 

call shmenu 
110 continue 

call gotoxy(13,10) 

write (6,10) » Enter Choice: * 

call getchr (choice) 

if ((choice .GE. 97) .AND. (choice .LE. 122)) choice = choice - 32 
if (choice .EQ. 78) then 

keynum = ! Show by name, 

else if (choice .EQ. 65) then 

keynum = 1 1 Show by address, 

else if (choice .EQ. 67) then 

keynum = 2 1 Show by city, 

else if (choice .EQ. 83) then 

keynum = 3 1 Show by state, 

else if (choice .EQ. 90) then 

keynum = 4 ! Show by ZIP. 

else if (choice .EQ. 80) then 

keynum = 5 1 Show by phone, 

else if (choice .EQ. 81) then 

goto 1000 
else 

goto 110 
endif 

call kmovfb ( lun , keynum, , status) 
call clrscr 
count = 
200 continue 

call kread (lun, 1,-1, buf , status) 
if (status .EQ. 0) then 

call output (buf) 

count = count + 1 

if (count .GE. 4) then 
write (6,10) ' *' 
call getchr (value) 
count = 

endif 

goto 200 
endif 
if (count .NE. 0) then 

write (6,10) • *• 

call getchr (value) 
endif 
1000 continue 
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10 format (A) 
return 
end 

subroutine menu 
call clrscr 



10 





write 


(6,10) 


i i 




write 


(6,10) 




+ 




i ************************************************* i 


. 


write 


(6,10) 




+ 




i* 


*! 




write 


(6,10) 




+ 




t* 


PHONE DIRECTORY MAIN MENU *' 




write 


(6,10) 




+ 




i* 


*» 




write 


(6,10) 




+ 




•* A = 


Add a new record. *' 




write 


(6,10) 




+ 




■* D = 


Delete the current record, (on screen) . *' 




write 


(6,10) 




+ 




'* F = 


Find a record. *' 




write 


(6,10) 




+ 




• * s = 


Show records by name, city, zip, or phone. *' 




write 


(6,10) 




+ 




•* Q = 


Quit. *' 




write 


(6,10) 




+ 




i* 


*i 




write 


(6,10) 




+ 




i **************************************************** i 




return 






format (13x, A) 






end 







subroutine f dmenu 
call clrscr 



write (6,10) 

write (6,10) 

write (6,10) 

write (6,10) 

write (6,10) 

write (6,10) 

write (6,10) 

write (6,10) 

write (6,10) 

write (6,10) 

write (6,10) 
return 
10 format (13x, A) 
end 



SEARCHING MENU' 



N = Search by name. ■ 

A = Search by address. ' 

C = Search by city. ' 

S = Search by state. ' 

Z = Search by ZIP. * 

P = Search by phone number. ' 

F = Find next occurrence of record. f 

Q = Return to main menu. ' 
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subroutine shmenu 
call clrscr 



write (6,10) 

write (6,10) 

write (6,10) 

write (6,10) 

write (6,10) 

write (6,10) 

write (6,10) 

write (6,10) 

write (6,10) 

write (6,10) 
return 
10 forraat(13x,A) 
end 



SHOW MENU' 



N = Shew alphabetically by name. ' 
A = Show alphabetically by address. ' 
C = Show alphabetically by city. ' 
S = Show alphabetically fcy state. * 
Z = Show numerically by ZIP. * 
P = Show numerically by phone number, 
Q = Return to main menu. ' 



subroutine output (buf) 

character *81 buf , buf 1 

character *24 addres 

character *20 name, city 

character *2 state 

character *5 zip 

character*10 phone 

equivalence (buf 1(1:1) ,name(l:D) ,(bufl(21:21) ,addres(l:D) 
equivalence (bufl(45:45) ,city(l:D) ,(bufl(65:65) ,state(l:D) 
equivalence (bufl(67:67) ,zip(l:l) ) , (bufl(72:72) ,phone(l:D) 

buf 1 = buf 

write (6,10) name, '\n' 
write (6,10) addres,'\n' 
write (6,10) city, state,' »,ZIP, '\n' 

write (6,10) •(', phone (1:3) ,') ',phone(4:6) ,'-' ,phone(7:10) , '\n* 
write (6,10) ' • 
10 format (7A) 
return 
end 

subroutine getchr(valuel) 

C ** This subroutine gets one character from the keyboard and returns 
C the ASCII value into the variable passed. Control is returned 
C to the program immediately after the character is typed (No 
C Carriage Return <CR> needed. 

implicit undefined (a-z) 
integer *4 nrecs, status 
integer*2 valuel , value2 
character*! value 



4-21 



Keyed Sequential Access Method (KSAM) 

equivalence (value2, value) 

call read (l,-l,0,-l,value,l,nrecs, status) 

valuel = value2 / 256 

return 

end 

subroutine trim (input, output, length) 
C 

C ** This subroutine is used to get the actual length of the variable. 
C ** It receives The variable in input and returns the variable in output. 
C ** With the actual length returned in length. 
C 

character * ( *) input , output 

integer length 

length = len( input) 
100 continue 

if (input (length: length) .BQ. ' •) then 

length = length - 1 

goto 100 
endif 

output = input (l:length) 
return 
end 

subroutine gotoxy( line, column) 

C ** This routine puts the cursor at a location on the screen. The screen has 

C 25 lines and 80 columns. 

C 

C ** This routine is unique to the WICAT T7000, or M38000 terminal. You may 

C need to rewrite the subroutine for your specific terminal. 

integer *4 line, column 
character *1 esc 
data esc /z'lB 1 / 

write (6,10) esc, "[", line,";", column, "H" 
10 format(2A,I2.2,A,I2.2,A) 
return 
end 

subroutine clrscr 

C ** This routine clears the screen and puts the cursor at location 1,1 on the 

C screen. The screen has 25 lines and 80 columns. 

C 

C ** This routine is unique to the WICAT T7000, or M38000 terminal. You may 

C need to rewrite the subroutine for your specific terminal. 

character *1 esc 

data esc /z'lB'/ 
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write (6,10) esc, '[2J 1 
10 format (2A) 
return 
end 
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Directory of System Calls 



_J*LARM - Set alarm clock 

_ALLOC - Allocate a device 

..ALLMEM - Allocate dynamic memory 

_ANDEVNT - Wait for AND of event flags 

_ASSIGN - Assign a logical name 

_CHDIR - Set default device and directory 

_CHSUPER - Change to supervisor mode 

_CHUSER - Change processor mode to user 

_CLGNE - Create a duplicate process 

_CLOSE - Close a file 

_CLREVNT - Clear event flags 

_GONNECF - Establish connection with remote machine 

_CREATE - Create a file 

_CREATS - Simplified file creation 

_CRERCS - Simplified create process 

_CRPROC - Create a new process 

_CRSHDP - Enable/disable crash display 

_CERLC - Set/clear [CTRL] c protection 

_DCONALL - Disconnect all remote process connections 

_JXDNIDLE- Disconnect idle remote process connections 

_DEALLOC - Deallocate an allocated device 

JDETOPRT - Set default device protection 

_J)ETOUIC - Set default device UIC 

_JDEFMEM - Define named shared memory area 

_JDEFPROT - Set default protection mask 

_DEINST - Deinstall privileged file 

_PELETE - Delete a file 

_PISOONN - Break connection to remote machine 

_PISMNT - Dismount a logical device 

JDUELUN - Duplicate Logical Unit number of a file 

_ERRNO - Receive process abort reason 

_EXITRTN - Define a returnable exit handler 

_EXPROC - Terminate the specified process 

_JLUSH - Flush I/O buffers to the device 

_PREWAIT - Wait for fast read to complete 
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.JTREMEM - Deallocate a page of memory 

_GASSIGN - Assign a global logical name 

_GE1JGY - Get PID of ancestor process 

_GETALC - Get names of allocated devices 

_GETATIR - Get PCB attribute bits 

_GE , H>IR - Get default device and directory 

.GETDNAM - Get device name 

_GE1DPRT - Get device protection 

_GETDST - Get device status 

_GE1DUIC - Get device UIC 

_GETEVNT - Read event flags 

_GETEXIT - Get address of current exit handler 

_GETFCB - Get file control block 

_GETFID - Get file ID 

_GETFNAM - Given a lun, return the filename 

_GETFPRT - Get file protection 

_GETFRE - Get amount of available memory 

_GETFRSZ - Get file record size 

_GETFUIC - Get file UIC 

_GETCIB - Retrieve a global logical name 

_GETINST - Get installed privileged image 

_GETLOG - Retrieve a logical name 

_GETMLST - Get a entry from list of named shared memory areas 

_GE'INNAM - Get network nodename given site ID 

_GE I INSID - Get network site ID give nodename 

_GETPCB - Get process control block 

_GETPID - Get process ID (PID) from name 

_GETPNAM - Get process name from PID 

_GETPOS - Get the current file position 

_GETPRI - Get process's priority 

_GETPROT - Get default protection mask 

_GETPRV - Get process privilege 

_GETREL - Get names of rotor list elements 

JSETRTR - Get rotor list names 

.GETTFIC - Get internal tick count 

_GETTIM - Get the current date and time 

_GEnMSL - Get scheduling time slice 

_GETUIC - Get process UIC 

_GIODST - Get device status with lun 

_GMAIL - Receive interprocess mail 

_HEBERN - Hibernate a process 

_INSTALL - Install privileged file 

_jCCLALL - Close all KSAM files 

_J(CLOSE - Close a KSAM file 

.JCCREAT - Create a KSAM file 

_£DELET - Delete a KSAM record 

_KFIND - Locate a KSAM record 

.JCFLUSH - Write modified KSAM buffers 

_KINPO - Retrieve KSAM file information 

.JCMOVEB - Position to front or back of file 
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_J(OPEN - Open a KSAM file 

__KREAD - Read a KSAM record 

_KUNLCK - Unlock specified KSAM records 

.JOJPDAT - Update an existing KSAM record 

.JWRTTE - Write a new KSAM record 

_JJOCK - Lock records within an open file 

_WAPFP - Maps physical address into logical address space (floating point) 

_MAPPHYS - Maps physical address into logical address space 

.JEMMNT - Mount a logical device from memory 

_JOUMP - Mount a logical device 

_JfJLCRPS - Multiple create process 

_OPEN - Open a file 

_QREVNT - Wait for OR of event flags 

_ORIGPKV - Get original process privilege 

^PHYSIO - Perform physical I/O operation 

_JPHYSOP - Perform physical device operation 

_PIDLST - Get list of all known PIDs on the system 

_PRCLST - Get PID's on a priority level 

_FRIRAT - Set priority scheduling ratio 

_EROTMEM - Change memory page protection 

_RDPMEM - Read physical memory 

_READ - Read from an open file 

_J*ENAME - Rename a file 

_RNIDLST - Get list of all known remote IDs 

_RSIDLST - Get list of all known SIDs given remote network 

.JSETATTR - Set PCB attribute bits 

_SETOPRT - Set device protection 

_SETDST - Set device status 

_SETOUIC - Set device UIC 

_SETEVNT - Set event flags 

_SETEXIT - Define exit handler 

_SETFCB - Write tile control block 

_SETFID - Set file ID 

_SETFPRT - Set file protection 

_SETFRSZ - Set file record size 

_SETFUIC - Set file UIC 

_SEEMPRT - Change access protection of a named shared memory area 

_SEEMUIC - Set named memory area UIC 

_SETPNAM - Change process name 

_SETPOS - Set the current file position 

_SETPRI - Change process's priority 

_SETPFV - Set process privilege 

_SE1RTM - Set/Clear real time mode flag 

_SETRTR - Assign device names to a rotor list 

_SEITIM - Set system date and time 

_SETTMSL - Change scheduling time slice 

_SETTRP - Initialize a user defined trap 

_SETUIC - Set process UIC 

_SHRMEM - Share a named shared memory area 

_SIDLST - Get list of all known Site IDs 
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.SIODST - Set device status with lun 

.SKIP - Position tape 

.SMAIL - Send interprocess mail 

.TRANPID - Translate another processes logical name 

.TRANS - Translate a logical name 

JJDEFMEM - Undef ine a named shared memory area 

.UNLOCK - Unlock records in an open file 

.USHRMEM - Uhshare a named shared memory area 

.VERSION - Get the OS version banner 

.WAIT - Pause for a period of time 

.WAKE - Wake a hibernated process 

.WAKEC - Wake a hibernated process with count 

.WRITE - Write to an open file 

JWTPMEM - Write physical memory 
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The specified operation was performed successfully (i.e., the 
request made of the WMCS was successfully completed) . 

Diagnostic name: 



KERNEL Diagnostic Messages 

1 The process lacks the privileges required to perform the operation. 

Each process is assigned a set of privileges, i.e., rights or 
prerogatives within the WMCS. When a process asks the WMCS to do 
something, the process must have the right or prerogative to make 
such a request. Otherwise, the requested operation is not 
performed. 

Diagnostic name: errinsufpriv 

2 The specified process is not in the system process table. 

The WMCS assigns a PID (process identification number) to each 
process. Some requests require that the PID of the target process 
be specified as part of the request. This status is assigned to a 
request when the specified PID does not match the PID of any of the 
current processes, i.e., the PID could not be found in the system's 
list, or table, of current processes. 

Diagnostic name: errprcsnotfnd 

3 The process's buffer does not begin on a word boundary. 
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Several of the system calls require that buffers provided fcy the 
calling process be word aligned. This diagnostic message is sent 
when the WMCS expects a word aligned buffer and the buffer provided 
by the calling process is not word aligned. 

Diagnostic name: erroddbufaddr 

4 The logical address, for the memory requested, is invalid. 

The WMCS routines that deal with the allocation and deallocation of 
memory require that a page address be designated. The page address 
must be within the logical address space of the calling process and 
must begin on a 4 Kbyte boundary. Otherwise, this message is 
specified. 

Diagnostic name: errinvadr 

5 The process requested a logical page that was already allocated. 

WICAT hardware allows processes to assign pages of physical memory 
to addresses within the logical address space of a process. This 
status is assigned when a process specifies a logical address to 
which memory is already assigned. 

Diagnostic name: errmemalloc 

6 The process tried to affect a page in memory it did not own. 

A process may not own all the pages of memory in its logical 
address space. For example, the pure code for a process can be 
shared with another process (this sharing is effected when the 
latter process is created) . When pages are shared, neither process 
owns the page, and attempts to deallocate or modify the protection 
assigned to these pages results in this status. 

Diagnostic name: errnonowned 

7 All available memory has been allocated. 

Memory is allocated for processes (process creation, explicit calls 
for memory allocation, automatic stack growth) , as well as for the 
system itself (process tables, disk caches, device drivers, open 
files, etc.) . This status is assigned to a process whose request 
requires more memory than is available. 

Diagnostic name: errnomamavail 

8 The specified site ID does not exist. 
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Each WICAT system has a site identification number that identifies 
the system. Several system calls allow a process to specify the ID 
numbers of the sites that will be affected fcy a request. This 
status is assigned when the WMCS does not recognize the specified 
site ID number. 

Diagnostic name: errinvsiteid 

9 The process attempted to release memory that does not exist. 

The logical address space assigned to the process does not include 
the address of the page that the process asked the WMCS to release, 
i.e., the process does not have a page of memory at the address 
specified. 

Diagnostic name: errmenadeall 

10 An arithmetic operation produced a number longer than 32 bits. 

An arithmetic overflow occurred when the WMCS tried to calculate 
the position (within a file) of a particular record. In other 
words, the calculation resulted in a number that could not be 
contained in 32 bits. 

Diagnostic name: errartiovflw 

11 No number was found during a search or scan for a number. 

The WMCS had to convert an ASCII string to a binary number, e.g., a 
file version number. 

This status is never returned to a user process. 

Diagnostic name: errnonuraber 

12 The file type is inappropriate for the given operation. 

The specified operation requires that the target file be a 
particular kind of file, e.g., a process asks the WMCS to install a 
file that is neither an image file nor a system file. 

Diagnostic name: errinapft 

13 The specified process already exists. 

This diagnostic is returned to the process that tries to create an 
additional copy of a system process (e.g., logf lush) . 

Diagnostic name: errprcsfnd 
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14 A negative number is not allowed for this parameter. 

A process specified a negative number for a parameter where a 
negative number is invalid. 

Diagnostic name: errnegnumber 

15 Trap number (during _SET'IRP) exceeds range of specifiable numbers. 

The process issued a _SETTRP system call and asked the WMCS to 
define a trap whose number does not correspond to a user-def ineable 
trap. 

Diagnostic name: errbadtrapnum 

16 The specified device is not allocated. 

This diagnostic is returned when a process requests that a device 
be deallocated, and it is not currently allocated. 

Diagnostic name: errnotalloc 

17 Insufficient memory to automatically extend the users stack. 

The user process has exceeded its user stack space. The WMCS has 
attempted to extend the stack space on behalf of the process, but 
there is no unallocated memory available. The process is 
terminated. 

Diagnostic name: errautostackexp 

18 The specified rotor list is empty. 

This diagnostic is returned when the process attempts to allocate a 
device using a rotor name as the name of the device, and there are 
no available devices in the list associated with that rotor. 

Diagnostic name: erremptyrtrlst 

19 The process was terminated because the remote connection was lost. 

This diagnostic is generated if a process is terminated because the 
connection from a port to a remote port is lost, and the local port 
is configured to delete processes associated with that port. This 
diagnostic is reported to the process that is terminated, and, if 
the process does not have an exit handler defined, it is reported 
to the parent process in the ccode parameter of the _CRPROC system 
call. 
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Diagnostic name: errremoteabort 

20 No interprocess mail, in system message table, for the process. 

The process issued a jGMAIL system call when no interprocess mail 
had been sent to the process. 

Diagnostic name: errnomail 

21 The specified file is not an image file. 

Some system functions (create, mount, allocate, etc.,) are defined 
only for image files. For example, a process might attempt to 
create a process by specifying a file that is not an image file. 

Diagnostic name: errnotirafle 

22 The queue control file is being deleted at the users request. 

This diagnostic is returned as a warning when the user specifies 
the morestart switch on the MNT command to mount a queue, and the 
queue manager deleted the queue control file. The queue control 
file contains the list of queue entries. 

Diagnostic name: errqctdeluser 

23 The queue control file is being deleted. It may be corrupted. 

This diagnostic is returned as a warning when a process mounts a 
queue, and the queue manager discovers that the queue control file 
contains erroneous data. The queue control file is deleted, losing 
any entries that may have been there. 

Diagnostic name: errqctdelupdat 

24 The process has already allocated floating point haroVare. 

This diagnostic is returned when the process attempts to map 
floating point haroVare into its address space after it has already 
done so. That is, a process cannot map floating point hardware 
more than once. 

Diagnostic name: errhavemath 

25 The process has an undefined trap: floating point. 

A floating point exception has occurred. Note that if the process 
had set up a floating point trap handler (using _SETTRP) , the 
floating point exception would have caused a transfer to the 
floating point trap handler rather than the termination of the 
process. 
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If the process was spawned, this status is sent to the ccode 
parameter of the _CRPROC system call to the parent process. 

A process crash display, or stack dump, is also written to the 
SYS$ERROR file assigned to the terminated process. 

Diagnostic name: errflpointtrap 

26 The process abort status was forced to a normal exit status. 

A process can specify this diagnostic code in the result parameter 
of the _exproc system call to force a normal exit status (0) 
overriding the current process abort reason code. 

Diagnostic name: errnorraalexit 

27 The process was killed by another process. 

This status results when a process is terminated by another 
process, e.g., when a proces's is terminated by the KILL Command. 

If the terminated process was spawned (and is terminated by a third 
process that called _EXPROC) this status is sent to the ccode 
parameter of the _CRPROC system call to the parent process. 

Diagnostic name: errforcedexit 

28 The system clock reached the value specified for _^LARM. 

A process set a duration period, i.e., an alarm, and the duration 
expired before the process was completed. 

If the process was spawned, this status is sent to the ccode 
parameter of the _CRFROC system call to the parent process. 

Diagnostic name: erralarmexit 

29 The process has an undefined trap: divide-by-zero. 

The process attempted to divide by zero. Note that if the process 
had set up a divide-by-zero trap handler (using _SET'IRP) , the 
attempt to divide by zero would have caused a transfer to the trap 
handler rather than the termination of the process. 

If the process was spawned, this status is sent to the ccode 
parameter of the _CRPROC system call to the parent process. 

A process crash display, or stack dump, is also written to the 
SYS$ERROR file assigned to the terminated process. 
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Diagnostic name: errzerodivtrap 

30 The process has an undefined trap: CHK Instruction. 

This status results when a process is terminated because it 
generated a CHK trap. Note that if the process had set up a CHK 
trap handler (using .J3ETTRP) , the CHK trap would have caused a 
transfer to the trap handler rather than the termination of the 
process. 

If the process was spawned , this status is sent to the ccode 
parameter of the _CRPRQC system call to the parent process. 

A process crash display, or stack dump, is also written to the 
SYS$ERROR file assigned to the terminated process. 

Diagnostic name: errchktrap 

31 The process has an undefined trap: TRAPV Instruction. 

This status results when a process is terminated because it 
generated a TRAFV trap. Note that if the process had set up a 
TRAIV trap handler (using _SETTRP) , the TRAFV would have caused a 
transfer to the trap handler rather than the termination of the 
process. 

If the process was spawned, this status is sent to the ccode 
parameter of the _CRPROC system call to the parent process. 

A process crash display, or stack dump, is also written to the 
SYS$ERROR file assigned to the terminated process. 

Diagnostic name: errtrapvtrap 

32 The process has an undefined trap: TRACE. 

The process generated a TRACE trap and was terminated. Note that if 
the process had set up a TRACE trap handler (using _SETTRP) , the 
TRACE trap would have caused a transfer to the trap handler rather 
than the termination of the process. 

If the process was spawned, this status is sent to the ccode 
parameter of the _CRPR0C system call to the parent process. 

A process crash display, or stack dump, is also written to the 
SYS$ERROR file assigned to the terminated process. 

Diagnostic name: errtracetrap 
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33 The process has an undefined trap: 1010 Instruction. 

The process was terminated because it attempted to execute a 1010 
instruction. Note that if the process had set up a 1010 trap 
handler (using _SETTRP) , the 1010 instruction would have caused a 
transfer to the trap handler rather than the termination of the 
process. 

If the process was spawned, this status is sent to the ccode 
parameter of the _CRPROC system call to the parent process. 

A process crash display, or stack dump, is also written to the 
SYS$ERROR file assigned to the terminated process. 

Diagnostic name: errlOlOtrap 

34 The process has an undefined trap: 1111 Instruction. 

The process was terminated because it attempted to execute an 1111 
instruction. Note that if the process had set up an 1111 trap 
handler (using _SETERP) , the 1111 instruction would have caused a 
transfer to the trap handler rather than the termination of the 
process. 

If the process was spawned, this status is sent to the ccode 
parameter of the _CRPROC system call to the parent process. 

A process crash display, or stack dump, is also written to the 
SYS$ERRQR file assigned to the terminated process. 

Diagnostic name: errlllltrap 

35 The process attempted to execute a privileged instruction. 

The process attempted to execute a privileged instruction while the 
process was in user mode. These are the privileged instructions: 

STOP 

MOVE xx, SR 
AND xx, SR 
OR xx, SR 
XOR xx, SR 
MOVE Ax,USP 
MOVE USP,Ax 
RESET 
RTE 

If the process was spawned, this status is sent to the ccode 
parameter of the _CRPROC system call to the parent process. 
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A process crash display, or stack dump, is also written to the 
SYSSERRQR file assigned to the terminated process. 

Diagnostic name: erprivintrap 

36 The process attempted to execute an illegal instruction. 

The process attempted to execute an illegal instruction, i.e., an 
instruction that is not recognized by the MC68000 microprocessor. 

If the process was spawned, this status is sent to the ccode 
parameter of the _CREROC system call to the parent process. 

A process crash display, or stack dump, is also written to the 
SYS$ERROR file assigned to the terminated process. 

Diagnostic name: errillintrap 

37 The process accessed nonexistent physical memory (bus error) . 

The process generated a bus error. A bus error pertains to the 
system's hardware, and is any access to an address at which there 
is no memory or memory mapped device. 

The process is also terminated, unless the bus error results from a 
call to _WTPMEM or _RDPMEM. 

If the process was terminated (and was a spawned process) , this 
status is sent to the ccode parameter of the _CREROC system call to 
the parent process. 

A process crash display, or stack dump, is written to the SYS$ERRQR 
file assigned to the process (if the process is terminated) . 

Diagnostic name: errbustrap 

38 The process accessed a word on a byte boundary (address error) . 

The process caused an address error. An address error is generated 
by the MC68000 microprocessor when when the address of a word or 
long word operand is odd rather than even. 

If the process was spawned, this status is sent to the ccode 
parameter of the _CRFROC system call to the parent process. 

A process crash display, or stack dump, is also written to the 
SYS$EREOR file assigned to the terminated process. 

Diagnostic name: erradrtrap 
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39 The process accessed nonexistent logical memory (memory violation) . 

The process caused a memory violation. A memory violation occurs 
when a process attempts to access an address in logical memory 
($000000 - $1FFFFF) to which no memory has been assigned, or when a 
process in user mode accesses any address greater than $1FFFFF. 

If the process was spawned, this status is sent to the ccode 
parameter of the _CRPROC system call to the parent process. 

A process crash display, or stack dump, is also written to the 
SYS$ERROR file assigned to the terminated process. 

Diagnostic name: errnonexmem 

40 The process has a memory parity-error. 

The process was terminated because it attempted to access a 
location in memory whose contents had been altered because some 
aspect of the system's hardware malfunctioned. 

If the process was spawned, this status is sent to the ccode 
parameter of the _CRPROC system call to the parent process. 

A process crash display, or stack dump, is also written to the 
SYS$ERROR file assigned to the terminated process. 

Diagnostic name: errmemparity 

41 The process attempted to write to a w rite-protected page in memory. 

The process attempted to write to an address on a write-protected 
page of logical memory. Write-protected portions of logical memory 
include the following: 

Pure code shared by processes. 

Pages write-protected by the process that owns them. 

If the process was spawned, this status is sent to the ccode 
parameter of the _CRPROC system call to the parent process. 

A process crash display, or stack dump, is also written to the 
SYS$ERROR file assigned to the terminated process. 

Diagnostic name: errwriteprot 

42 A handler was not defined before a TRAP instruction was executed. 
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The process attempted to execute a TRAP instruction for which it 
had not used the _SETTRP system call to define a trap handler. 

If the process was spawned, this status is sent to the ccode 
parameter of the _CREROC system call to the parent process. 

A process crash display, or stack dump, is also written to the 
SYSSERROR file assigned to the terminated process. 

Diagnostic name: errundeftrap 

43 The WMCS does not recognize the SVC number used by the process. 

The process specified an undefined SVC number in an attempt to 
execute a system call. 

If the process was spawned, this status is sent to the ccode 
parameter of the _CRPROC system call to the parent process. 

A process crash display, or stack dump, is also written to the 
SYS$ERRDR file assigned to the terminated process. 

Diagnostic name: errundefsvc 

44 The process has lost Data Set Ready on a tty line it controlled. 

This diagnostic is generated if a process is terminated because the 
connection from a port to a remote port is lost, and the local port 
is configured to delete processes associated with that port. This 
diagnostic is reported to the process that is terminated, and, if 
the process does not have an exit handler defined, it is reported 
to the parent process in the ccode parameter of the _CREROC system 
call. 

Diagnostic name: errdsrloss 

45 Ihis item is not implemented yet. 

This function has not yet been implemented, but will be implemented 
in a future release of WMCS. 

Diagnostic name: errnotiiqp 

46 The spawned child has terminated. 

A child process created by a surrogate process has terminated. 
Note that when a process is spawned by a surrogate process, the 
surrogate process does not go to sleep in a child wait, but 
continues execution. When the spawned child process terminates, 
rather that waking up the parent process, the O.S. kills the 
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surrogate process with this error code, and the surrogate process's 
exit handler then makes a reply packet to the remote parent 
process. 

Diagnostic name: errspawndone 

47 The process was not allowed to log on to the remote system. 

The user ID from the given site ID of the process is not allowed to 
log on to the desired remote system. 

Diagnostic name: errremotelogon 

48 (WMCS error) Nondelete, or critical , count is too large (overflow) . 

This status represents an error within the WMCS, i.e., the user 
process is not at fault. 

Diagnostic name: errsetdelovfl 

49 (WMCS error) Nondelete, or critical, count is less than 
(underflow) . 

This status represents an error within the WMCS, i.e., the user 
process is not at fault. 

Diagnostic name: errclrdelovfl 

50 Supervisor's stack does not contain enough parameters (underflow). 
Iwo stacks are associated with each process: 

user - used while the process is in user mode 

system - used when the process calls the WMCS 

This status results when the process expects data from the system 
stack and the system stack is empty. 

This occurs when a process is running in supervisor mode and calls 
the WMCS without having pushed the requisite number of parameters. 

Diagnostic name: errprevalloc 

51 User's stack does not contain enough parameters (underflow) . 
TWo stacks are associated with each process: 

user - used while the process is in user mode 
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system - used when the process calls the WMCS 

This status results when the process is running in user mode and 
calls the WMCS without having pushed the requisite number of 
parameters. 

Diagnostic name: errustckunfl 

52 No network virtual circuits are available for this operation. 

All of the network virtual circuits have already been allocated , 
leaving insufficient network virtual circuits available to make a 
connection to a remote machine in order to complete this operation. 

Diagnostic name: errnodevavail 

53 The specified node could not be found. 

The system network tables do not contain an entry corresponding to 
the specified node name. 

Diagnostic name: errnonodefnd 

54 The originator process has been aborted. 

The remote originator of a surrogate process has been terminated. 
(This error will never be received fcy a user process. It will only 
be sent by the OS to a surrogate process.) 

Diagnostic name: error igterra 

55 Remote process creation is not allowed by the remote system. 

The process does not have the privilege required on the remote 
system in order to create a process on the remote system. 

Diagnostic name: errnoremcrproc 

56 The table ends before the specified occurrence. 

The following system calls enable a process to request an item from 
a system table: 

_GETONAM, _GEELOG, jGETINSr 

When a process uses one of these system calls, the process must 
specify the position in the list, or table, of the item. 

This status results when the list is not long enough to include the 
ordinal number specified, e.g., a process requests the name of the 
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fifth device in a particular list, and the list contains only four 
devicenames. 

Diagnostic name: erridxrange 

57 The siteid verification failed for the specified network node. 

The site ID verification process for the specified network node 
failed. 

Diagnostic name: errsiteinvalid 

58 The priority ratio for the scheduler is less than or equal to zero. 

The priority ratio is the number of processes, at any level of 
priority, that will be scheduled (for processing) for each process 
at the next lower level of priority. 

This status results when the ratio assigned (using _PRIRAT) to the 
scheduler is less than or equal to zero. 

Diagnostic name: errprior ratio 

59 The address, sent to an SVC, exceeds user's logical address space. 

The WMCS requires that all addresses that it receives from a user 
process be within the logical address space assigned to the user 
process ( $000000 through $1FFFFF) . This keeps processes from 
affecting the WMCS and other processes. 

This status results when an address exceeds the logical address 
space for the user process. 

Note that a process operating in supervisor mode can access 
addresses grater than $1FFFFF. 

Diagnostic name: erraddovfl 

60 The size, sent to an SVC, is out of range. 

The size parameter associated with this system call contains an 
unacceptable value. For instance, this diagnostic is returned to 
the process attempting to share a named shared memory segment, and 
the size specified is zero or, the size specified is not large 
enough to accommodate the entire memory segment. 

Diagnostic name: errsizovfl 

61 An invalid value was specified. 
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The value specified for the parameter is not valid. 
Diagnostic name: errinwalue 

62 The process was killed because of a SWAPPER I/O error. 

The swapper was unable to read the process from the swap file to 
restore it to memory and allow it to run. 

Diagnostic name: errswapio 

63 (Floating point diagnostic) Illegal instruction given to FFP board. 

An illegal operation code was sent to the FFP harcVare floating 
point board. 

Diagnostic name: errffpillinst 

64 An invalid character appears in a decimal string. 

This status results when a process asks the WMCS to convert a 

decimal ASCII string to a binary string ( for example, a file 

version number) and the WMCS encounters a nonnumeric character in 
the string. 

Diagnostic name: errinvnumchar 

65 (Floating point diagnostic) Device does not respond. 

This status indicates a malfunction in the floating point harcVare. 

A timer is set whenever the floating point processor is assigned a 
task. Ihis status is assigned when the processor does not complete 
the task in the allotted time, and the process is terminated. All 
processes in the middle of a floating point operation when this 
status is assigned are also terminated. 

If the process was spawned, this status is sent to the ccode 
parameter of the _CRPROC system call to the parent process. 

Diagnostic name: errraathbrdfail 

66 (Floating point diagnostic) Divide-by-zero error. 

The process was terminated because it attempted to use the floating 
point software or harcVare to divide by zero. 

If the process was spawned, this status is sent to the ccode 
parameter of the _CRPROC system call to the parent process. 
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A process crash display, or stack dump, is also written to the 
Sys$ERROR file assigned to the terminated process. 

Diagnostic name: errdivO 

67 (Floating point diagnostic) Number is too small. 

The process was terminated because the result of the floating point 
operation was too small to be represented in the floating point 
format. In other words, the exponent that results from the 
normalization of a floating point operation does not fit in the 
exponent field of the floating point format. 

If the process was spawned, this status is sent to the ccode 
parameter of the _CRPROC system call to the parent process. 

A process crash display, or stack dump, is also written to the 
SYS$ERRQR file assigned to the terminated process. 

Diagnostic name: errunderflo 

68 (Floating point diagnostic) Number is too large. 

The process was terminated because the result of the floating point 
operation was too large to be represented in the floating point 
format. In other words, the exponent that results from the 
normalization of a floating point operation does not fit in the 
exponent field of the floating point format. 

If the process was spawned, this status is sent to the ccode 
parameter of the _CRPROC system call to the parent process. 

A process crash display, or stack dump, is also written to the 
SYS$ERROR file assigned to the terminated process. 

Diagnostic name: erroverflo 

69 (Floating point diagnostic) Illegal operation. 

The process was terminated because it asked the floating point 
hardware to perform an undefined operation, e.g., the square root 
of a negative number, the log of a negative number, or raising a 
negative number to a power. 

If the process was spawned, this status is sent to the ccode 
parameter of the _CRP!ROC system call to the parent process. 

A process crash display, or stack dump, is also written to the 
SYS$ERROR file assigned to the terminated process. 
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Diagnostic name: errillegalop 

70 (Floating point diagnostic) Denormalized operand. 

The process was terminated because it performed a floating point 
operation that produced a denormalized result. 

If the process was spawned/ this status is sent to the ccode 
parameter of the _CRFR0C system call to the parent process. 

A process crash display, or stack dump, is also written to the 
SYS$ERRQR file assigned to the terminated process. 

Diagnostic name: errdenormop 

71 This operation is not allowed on a SURROGATE process. 

The operation attempted cannot be done to a surrogate process. 
Diagnostic name: errsurrogate 

72 A connect packet was received after the connection was made. 

After a valid connection has been made by the network, a connect 
packet was received. (This error should not be received by a user 
process.) 

Diagnostic name: errdupconnect 

73 An SVC packet was received before the connect packet was received. 

A connection must be established with a remote node via a connect 
packet before any SVC packets or special packets may be sent. 

Diagnostic name: errnoconnect 

74 The disconnect packet was not from the originator process. 

Only the process that initiated a connection may terminate the 
connection via a disconnect packet. 

Diagnostic name: errwrngorigpid 

75 A packet was received for a local-execution-only SVC. 

Certain SVCs may not be executed remotely, but only on the local 
machine. If a local-execution-only SVC packet type is received by 
a surrogate process, it will generate a reply packet with this 
error. 
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Diagnostic name: errnotremotesvc 

76 The actual packet size is not the same as the size in the header. 

The number of data bytes read by the network software for the 
current packet does not agree with the number of bytes that the 
packet header indicated were to follow. 

Diagnostic name: errbadpktsize 

77 The reply packet SVC is not the same as the request packet SVC. 

The SVC number in the reply packet is not the SVC number that was 
sent to the remote system. 

Diagnostic name: errbadpktsvcno 

78 All available memory has been allocated on the remote system. 

There is no memory available on the remote system to perform the 
requested operation. 

Diagnostic name: errnoreraotenem 

79 The process is incompatible with the current operating system 
version. 

Certain utility programs contain intimate knowledge about a 
particular version of WMCS. If a program that requires a specific 
version of WMCS to operate correctly detects that the version of 
WMCS is different than the required version, this error message is 
returned. 

Diagnostic name: errwrongos 

80 The specified name must not be null. 

This diagnostic is returned to the process attempting to define a 
named shared memory segment with a null name. Null names are not 
allowed for named shared memory segments. 

Diagnostic name: errnamenull 

81 The specified name already exists. 

This diagnostic is returned to the process attempting to define a 
named shared memory segment using a name that is already defined as 
a named shared memory segment. 
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Diagnostic name: errnameexists 

82 The specified name does not exist. 

This diagnostic is returned to the process attempting to share a 
named shared memory segment, and a segment with the specified name 
cannot be found. 

Diagnostic name: errnoname 

83 Process killed because of a queue restart request. 

The Queue Manager was requested to restart a process , so it killed 
the currently running version of the process. This error is to 
enable special restart handling or cleanup of jobs run in a queue. 

Diagnostic name: errquerestart 

84-127 No error assigned. 
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128 A request was not completed within the specified time. 

The process specified a timeout value, i.e., a duration, for the 
completion of a request, and the duration expired before the 
requested operation was completed. 

For example, a JREAD request was not completed in the specified 
time. 

Diagnostic name: errtimeout 

129 A file's version number cannot be greater than 65535. 

The process attempted to use the _CREATE or _CREATS system call to 
perform one or the other of these operations: 

Create a file with a version number greater than 65535. 

Create a file with a version number of zero in a directory 
that contains a file whose filename and extension match that 
of the file to be created, and whose version number is 65535. 

Diagnostic name: errinwernum 

130 The specified devicename is syntactically incorrect. 
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At least one element in the devicename field of the specified file 
designation is disallowed. 

Diagnostic name: errinvdevnam 

131 The WMCS does not recognize the devicename. Is the device mounted? 

The system device table, i.e., the list of mounted devices, does 
not contain the specified devicename. 

Diagnostic name: errundevnam 

132 The logical unit number does not correspond to an open file. 

No open file has a logical unit number matching the unit number 
specified. 

Diagnostic name: errinvlfn 

133 The specified file could not be found. 

The specified directory does not contain a file whose filename, 
file extension, etc., match the file designation specified. 

Diagnostic name: errfilnotfnd 

134 The specified version of the file already exists. 

A file already exists whose file designation matches that of the 
file specified. 

Diagnostic name: errfil exists 

135 The specified file is read-locked. 

The specified file is open and read-locked, i.e., it cannot be 
opened for read access. 

Diagnostic name: errreadlock 

136 The specified file is write-locked. 

The specified file is open and write-locked, i.e., it cannot be 
opened for write access. 

Diagnostic name: errwritelock 

137 The specified queue does not have a default definition. 
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This diagnostic is returned when a process attempts to open (using 
the _open or the _create system call) a queue class device, and 
there is no default create process definition for the specified 
queue, (see the rprinttype switch of the DSTAT command, and/or the 
_physop system call) . 

Diagnostic name: errquenodef 

138 This edit mode requires that the record length be set to one. 

The process opened, or created, a file with a record length other 
than one, and then (in an edit mode requiring that the file have a 
record length of one) attempted to read (_PEAD) or write to 
(_WKETE) the file. 

Diagnostic name: errinvreclen 

139 The specified file type is reserved for the WMCS. 

The process attempted to create a kind of file whose file type is 
reserved for the WMCS. 

Diagnostic name: errinvfiletype 

140 The process tried to read past the logical end of a file. 

The process attempted to use the _J*EAD system call to read records 
that are beyond the end of the file, i.e., they do not exist. 

Note that if some of the specified records exist they are read and 
no diagnostic message is reported, e.g., a process requests 10 
records and the file contains 5; the five are read and no 
diagnostics message is reported. 

Diagnostic name: errreadleof 

141 The process does not have read-access to the specified file. 

The process opened a file, did not request read access to that 
file, and then issued a system call that requires read access, 
e.g., _j*EAD. 

Diagnostic name: errnoreadacc 

142 The process does not have write-access to the specified file. 

The process opened a file, did not request write access, and then 
issued a system call that requires write access, e.g., _WRITE. 



B-21 



Glossary of WMCS Diagnostic Messages 

Diagnostic name: errnowriteacc 

143 The process does not have Execute Privilege for the file. 

The process cannot execute the specified file because the process 
does not have execute privilege for the file. Note that the owner 
of a file grants execute privilege to the various classes of users. 
The privileges granted to the class of users to which the process 
belongs is indicated in the file's protection mask. 

This status also results when a process attempts to access a file, 
e.g., use the _OPEN system call, when the process does not have 
execute privilege for one or more of the directories along the 
directory path to the file. Thus, a process must have the 
appropriate privilege for the file, and execute privilege for all 
directories belonging to the file's designation. 

Diagnostic name: errnoexecpriv 

144 The process does not have Read Privilege for the file. 

The process cannot open the file for read access because the 
process does not have read privilege for the file. Note that the 
owner of a file grants read privilege to the various classes of 
users. The privileges granted to the class of users to which the 
process belongs is indicated in the file's protection mask. 

This status also results when a process attempts to access a file, 
e.g., use the _OPEN system call, when the process does not have 
read privilege for the directory or device containing the file. 

Diagnostic name: errnoreadpriv 

145 The process does not have Write Privilege for the file. 

The process cannot open the file for write access because the 
process does not have write privilege for the file. Note that the 
owner of a file grants write privilege to the various classes of 
users. The privileges granted to the class of users to which the 
process belongs is indicated in the file's protection mask. 

This status also results when a process attempts to access a file, 
e.g., use the _PELETE system call, when the process does not have 
write privilege for the directory or the device containing the 
file. 

Diagnostic name: errnowritepriv 

146 The process does not have Delete Privilege for the file. 
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The process does not have delete privilege for the specified file, 
and attempted one of the following operations: 

Delete the file. 

Open the file (with the delete-upon-closing mode-bit set) . 

Dismount the device. 

Close the file (with the delete mode-bit set) . 

Note that the owner of a file grants delete privilege to the 
various classes of users. The privileges granted to the class of 
users to which the process belongs is indicated in the file's 
protection mask. 

Diagnostic name: errnodelpriv 

147 The specified filename is syntactically incorrect. 

The filename field of the specified file designation is 
syntactically incorrect. For example, it may contain characters 
disallowed in the filename field, or it may contain too many 
characters, etc. 

Diagnostic name: errinvfnstr 

148 The specified directory is not a directory- type file. 

While searching the directory path (the directories specified in 
the directory name filed of the specified file designation) , the 
WMCS encountered a file that is not a directory. 

Diagnostic name: erriiX7dirfle 

149 The specified directory name is syntactically incorrect. 

The directory name field of the specified file designation violates 
the syntax for that portion of the file designation. For example, 
it mnay contain characters disallowed in file designations. 

Diagnostic name: errinvdirstr 

150 The specified entry is already active. 

Once an entry in the queue has begun execution, it cannot be 
modified, put on hold, or awakened. This diagnostic is returned to 
the process that attempts to perform one of those operations on an 
active queue entry, (see the _physop system call) 
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Diagnostic name: errentryactive 

151 The WMCS cannot allocate more than 65535 sectors at a time. 

The process asked the WMCS to allocate more than 65535 sectors (a 
very large JWRITE request) . 

Diagnostic name: errinvsecreq 

152 The FCB (or the TFCB) does not correspond to its checksum. 

Each File Control Block (FCB) , or Tape File Control Block (TFCB) 
has a checksum associated with it, i.e., a sum of each of the 
values appearing in each field of the control block. 

This status results when a process refers the WMCS to an FCB or 
TFCB and the WMCS finds that the checksum and the data in the 
control block do not correspond. 

This helps the WMCS maintain the integrity of the file system on 
the device. 

Diagnostic name: errinvfcbcksum 

153 The specified file is open, has been marked for deletion. 

The process asked the WMCS to delete an open file, e.g., a file 
that another process has open. 

This status results as a WARNING, and when the process that has the 
file open closes the file, the file will be deleted. 

Diagnostic name: erropendel 

154 All available disk space has been allocated. 

The process asked the WMCS to allocate space on a volume on which 
all available space has been allocated. 

Diagnostic name: errnospace 

155 The specified queue is closed. 

This diagnostic is returned to a process which attempts to insert a 
new entry into a queue that is closed. A closed queue will not 
accept any new entries, but will continue to process all existing 
entries. 

Diagnostic name: errqueclosed 
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156 The specified sector/block size is not supported on this device. 

This status results when the sector size on a disk neither 512 nor 
1024, or when the block size on a tape is greater than 4096. 

Diagnostic name: errirarsectorsz 

157 The specified entry was not found. 

This diagnostic is returned to the process which attempts to access 
or modify an entry in a queue, and the specified entry does not 
exist. 

Diagnostic name: errentrynotfnd 

158 System files cannot be deleted. 

The process attempted to delete one of the following system files: 

/ROOEDIR/BIIMAP.SyS /ROOTDIR/PCB.SYS /ROO0DIR/FCBBITMAP. SYS / 
ROOIDIE/ROaroiR.DIR 

Diagnostic name: errdelfile 

159 System files cannot be renamed. 

The process attempted to rename one of the following system files: 

/ROOTD^BriMAP.SYS /ROOIEIR/FCB.SYS /ROOTDIR/FCBBITMAP. SYS / 
ROaCDIR/ROOTDIR. DIR 

Diagnostic name: errrenfile 

160 The device cannot be dismounted because files are still open on it. 

The process attempted to dismount a device on which files are still 
open. 

Diagnostic name: errf ilesopen 

161 The usage field in the file's PCB contains an unexpected value. 

The usage field of a File Control Block (FCB) indicates the use 
begin made of that PCB, i.e., whether the FCB is available 
(unassigned) , a primary FCB, or a continuation FCB. 

This status results when the WMCS refers to an FCB and finds that 
the usage field does not indicate the usage the WMCS expected, 
e.g., the WMCS anticipates that the specified FCB is a primary FCB 
and finds that the PCB's usage field indicates that the FCB is 
either available or that it is a continuation PCB. 
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Diagnostic name: errinvusagid 

162 The specified device was not properly configured. 

This diagnostic is returned when a process attempts to mount a disk 
whose boot block does not contain a media description block. For 
disks mounted special, this diagnostic is returned as a warning. 
This diagnostic is not returned to the user process as an error. 

Diagnostic name: errdrnotconfig 

163 The request cannot cross machine boundaries. 

The operation requested is not able to be done remotely. It must 
be performed on a local machine. 

Diagnostic name: errdiffmachine 

164 This device was improperly dismounted. 

While mounting the specified device, the WMCS found that the device 
had not been properly dismounted. This can happen when the 
SHUTDOWN Command is not used to reboot the system. 

Diagnostic name: errimprdmnt 

165 The read request is invalid. 

The process asked the WMCS to perform a task either too large or 
too small for the system to handle. 

Diagnostic name: errinvreadreq 

166 The request crosses a physical page boundary in memory. 

Some file system operations, e.g., a fast read, require that the 
data buffer exist entirely within a single page of physical memory. 
This status results when such an operation is specified and the 
data buffer crosses a physical page boundary. 

Diagnostic name: errpagebndry 

167 A file cannot be renamed to another device. 

The REN Command cannot be used to move a file to a device other 
than the device on which the file is located. 

Diagnostic name: errrendiffdev 
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168 The boot block has changed since the device was mounted. 

This status indicates that when the specified disk was dismounted , 
the data in the disk's boot block do not match the data read into 
memory when the disk was mounted. 

Diagnostic name: errdiffbthlk 

169 A sector (s) in the disk cache could not be written to the disk. 

The WMCS has made several unsuccessful attempts to write a sector 
from the disk cache to the disk. 

Diagnostic name: errnowritesec 

170 Operator privilege is required in order to change a network window 
size. 

The process must have operator privilege in order to change a 
network window size. 

Diagnostic name: errwindwszpriv 

171 The operation is inappropriate for physical devices in the network 
class. 

The operation requested may only be performed by logical devices 
(virtual circuits) , and not by physical network devices. 

Diagnostic name: errinvnetoper 

172 An error occurred in doing Huffman decompression on the network 
data. 

Network data were compressed using the Huffman compression 
algorithms, and during the decompression phase an error was 
detected, invalidating the data that was transferred. 

Diagnostic name: errdecorapress 

173 The operation is inappropriate for the device class. 

Some operations can be performed only on devices in a particular 
class (es) . For example, a process can rename a disk file, but not 
a mf-class file or a tape file (the rename operation is not 
defined for TTy-class files and tape files) . 

Diagnostic name: errirwcloper 
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174 Directories do not exist on the specified device. 

The target device for the specified operation does not contain 
directories, i.e., it is not a directory oriented device, and the 
specified operation requires that the target device have 
directories. 

Diagnostic name: errinvdirdev 

175 The specified device driver function code is disallowed. 

The specified function code (_FHYSOP) is not recognized by the 
device driver. 

Diagnostic name: errunknowncmd 

176 The process buffer is too small for the specified operation. 

The process used edit mode 2 or 4 to request a _READ, and the line 
that was read does not fit in the specified buffer for the user 
process. 

Diagnostic name: errbuftosmall 

177 The specified directory does not exist. 

At least one of the directories in the directory name field of the 
file designation could not be found. 

Diagnostic name: errdirnotfnd 

178 The FCB.SBQ number for the file does not match the specified PCB. 

The sequence number appearing on the specified File Control Block 
(FCB) does not correspond with one of the following (depending upon 
the manner in which the FCB was requested) : 

1. The FCB.SBQ number used to open the file, e.g., the process 
requests that the WMCS open the file by FCB.SBQ number. 

2. The FCB.SBQ number in the directory file that contains 
information on the files in that directory does not match 
the FCB (in FCB. SYS) for the specified file. In other 
words, each directory file (a file with a .DIR file 
extension) contains a list of the files in that directory. 
Part of the information on that list is the FCB.SBQ number 
for each file in the directory. When a file designation is 
used to specify a file, the WMCS searches the list in the 
directory file to obtain the FCB.SBQ number for the 
specified file and then searches FCB. SYS to find the FCB 
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itself so that the WMCS can then find the data constituting 
the file on the disk. This status indicates that the 
PCB.SBQ number in the list in the directory file, and the 
PCB.SBQ number on the specified PCB in PCB.SYS, do not 
match. 

Diagnostic name: errinvseqnum 

179 The specified device is already mounted. 

The process attempted to mount a device that is already mounted. 
Diagnostic name: errdevnamexs 

180 The WMCS does not recognize the specified device class. 

The device class, specified in the request that a device be 
mounted, is not a recognized device class. 

Diagnostic name: errinvclass 

181 The specified volume has no valid boot block. 

When the WMCS attempts to mount a disk, the WMCS reads sectors 
and 32 on the disk (each of these sectors contains a boot block) . 

The WMCS determines the validity of a disk's boot block by 
comparing the checksum (that is part of the boot block) with the 
sum of the values that appear in each field of the boot block. This 
status is assigned when the checksum and the data in the boot block 
do not correspond. 

When the WMCS attempts to mount a tape, the WMCS reads the first 
block from the tape and determines whether the data in that block 
correspond to the checksum. This status indicates that the data 
and the checksum do not correspond. 

Diagnostic name: errnobbfound 

182 The user's write request is too large to fit in the system buffers. 

There is insufficient system buffer space to hold the user's write 
request. 

Diagnostic name: errwritetoobig 

183 The process requested more than 3964 bytes of dynamic memory. 

One of the system tables is too large. This diagnostic is internal 
to the WMCS and is never assigned to a user process. 
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Diagnostic name: errinvdmreq 

184 Not enough network buffers are available for a remote connection. 

There are insufficient network buffers available to complete a 
remote connection. 

Diagnostic name: errnonetbufs 

185 The device class handler was not loaded when the system was booted. 

The process asked the WMCS to mount a device, and the class handler 
for the class to which the device belongs, has not been loaded. 

This status is also assigned when a process attempts to use the 
KSAM routines, and those routines have not been loaded. 

Diagnostic name: errnoclass 

186 The process tried to rename a directory as its own subdirectory. 

The process attempted to rename a directory as a subdirectory of 
itself. 

Diagnostic name: errinvdirren 

187 The WMCS cannot extend the FCB file. 

There is not enough free disk space to be able to extend the 
FCB. SYS file. 

Diagnostic name: errnoextfcbfil 

188 The specified device is already mounted, and has another name. 

The process asked the WMCS to mount a device that is already 
mounted and has been assigned another name. 

Diagnostic name: errprevinit 

189 The WMCS does not recognize the specified edit mode. 

The WMCS does not recognize the edit mode specified by the process. 
Diagnostic name: errinveditrod 

190 The specified device has already been mounted for synchronous use. 

The process asked that a device be mounted as an asynchronous 
communication line, and the WMCS found that the device is already 
mounted as a synchronous communication device. 
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Diagnostic name: errrantasync 

191 The specified device has already been mounted for asynchronous use. 

The process asked that a device be mounted as a synchronous 
communication device, and the WMCS found that the device is already 
mounted as an asynchronous communication device. 

Diagnostic name: errrantsync 

192 The specified tape speed is not 12, 25, 30, 50, 90, 100, or 125 
ips. 

The tape speed parameter of the device status block is not one of 
the recognized speeds. 

Diagnostic name: errinvtpspeed 

193 The specified tape density is not 800, 1600, 3200, 6250, or 6400 
bpi. 

The only valid values for tape density are 800, 1600, 3200, 6250 or 
6400 bpi. None of the values is valid for all types of tapes. Use 
the value that is appropriate for the type of tape being used. 

Diagnostic name: errinvtpdensity 

194 The network site ID on this machine is uninitialized. 

The system variable containing the site ID must be initialized 
before any network operations can be performed. 

Diagnostic name: errnositeid 

195 The network nodename on this machine is uninitialized. 

The system variable containing the nodename of the machine must be 
initialized before any network operations can be performed. 

Diagnostic name: errnonodename 

196 No error assigned. 

197 The process tried to access a record (on a tape) out of sequence. 

Random access is not possible on tape devices. Therefore, this 
status indicates that the process requested a record that is not 
the next record (relative to the position of the tape head) . 
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Diagnostic name: errbac^pos 
198-199 No error assigned. 

200 A directory file cannot have a version number greater than one. 

The process asked the WMCS to perform an operation that would have 
resulted in a directory file (a file with a .DIR file extension) 
with a version number greater than 1. The WMCS requires that all 
directory files have a version number of 1. 

Diagnostic name: errdirinwer 

201 No error assigned. 

202 The operation cannot be performed because a tape file is open. 

The process made a request that would have resulted in more than 
one file being open on a tape simultaneously; this is disallowed 
because random file access is not supported on tapes. 

Diagnostic name: errfilopen 

203-205 No error assigned. 

206 Ihe specified skip or erase tape-function is undefined. 

The process missed an unrecognized skip tape function (see _SKIP 
and _EHYSOP/_i 3 HYSIO) . 

Diagnostic name: errinvskpcmd 

207-209 No error assigned. 

210 The specified directory cannot be deleted; it contains files. 

The DEL Program assigns this status when a process attempts to 
delete a directory that contains files. 

Diagnostic name: errdelnempdir 

211-214 No error assigned. 

215 The specified device driver is unsuitable for this device class. 

An attempt was made to mount a device and assign it a device driver 
that is incompatible with the class to which the device belongs, 
e.g., mounting a disk drive and assigning it a TTY-class device 
driver. 
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Diagnostic name: errinvdrvclass 

216 The specified file does not contain a device driver. 

The file designated as the device driver does not contain a device 
driver, or is not a system file (the WMCS checks several fields in 
a file to determine whether the file contains a device driver) . 

Diagnostic name: errinvdriver 

217 The value specified for a KSAM key type is undefined. 

KSAM allows for multiples of signed and unsigned bytes, words, and 
long words as key types. This status is assigned when the 
specified type is not one of the types allowed (see _JCCREAT) . 

Diagnostic name: errbadkeytype 

218-220 No error assigned. 

221 One or more of the KSAM keys is not contained in the record. 

When KSAM reads a record, it checks to make sure that all key 
fields within that record contain the values identified in the key 
file. Ihis status is assigned when one or more of those key fields 
contains incorrect values. 

Diagnostic name: errkeynotinrec 

222 The KSAM key definition table is larger than 3500 bytes. 

The KSAM key definition table (used in JKCREAT) cannot be larger 
than 3500 bytes. 

Diagnostic name: errkeytabielen 

223 The specified file is not a KSAM data file. 

The file, specified in a call to _£OPEN, is not a KSAM data file. 
Note that a file's type is determined when the file is created, and 
that a file created with .JCCREAT is of the correct type. 

Diagnostic name: errnodataf ile 

224 The specified file is not a KSAM key file. 

The file, specified in a call to _KDPEN, is not a KSAM key file. 
Note that a file's type is determined when the file is created, and 
that a file created with .JCCREAT is of the correct type. 
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Diagnostic name: errnokeyfile 

225 The specified number of keys is less than or equal to zero. 

The first word in the ktable parameter of the _KCREAT system call 
specifies how many keys are defined in this KSAM file. This status 
indicates that the value assigned to the ktable parameter is either 
zero or a negative number. 

Diagnostic name: errnumofkeys 

226 The specified number of segments is less than or equal to zero. 

Each key in a KSAM file can consist of from 1 to 15 segments. This 
status indicates that, during the creation of a KSAM file) by means 
of _KCREAT) r the number of segments (for one or more keys) is less 
than or equal to zero. 

Diagnostic name: errnumofsegs 

227 The record size is less than 4 bytes or greater than 65534 bytes. 

KSAM allows record sizes of from 4 - 64434 bytes. This status 
indicates that the record size, specified in the reel en parameter 
of the _KCREAT system call, is not in the foregoing range. 

Diagnostic name: errrecsz 

228 A KSAM key for a word or longword key type is not word aligned. 

All signed or unsigned word or long word keys in a KSAM file must 
be word aligned within a record. This status indicates one or more 
of the word or long word keys specified in a call to .JCCREAT is not 
properly aligned. 

Diagnostic name: errsegalign 

229 The specified key length is not a multiple of the key- type length. 

The _KCREAT system call assigns this status to indicate that the 
length of a word key-field is not a multiple of two, or that the 
length of a longword key-field is not a multiple of four. 

Diagnostic name: errseglen 

230 Key number is greater than or equal to the number of defined keys. 

When a process creates a KSAM file, the process specifies the 
number of keys that each record will contain. This status 
indicates that, subsequent to the file's creation, a process refers 
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to a key whose number is greater than or equal to the number of 
keys in each record in the file, e.g., each record in a file 
contains five keys (numbered 0-4) and a process attempts to refer 
to a key whose number is 5 or more (the 5 is equal to the total 
number of keys in the file, but does not correspond to a key 
number) . 

Diagnostic name: errkeynotfnd 

231 This operation requires that the current key be defined. 

This status indicates that the required definition was not given. 
Diagnostic name: errkeynotdef 

232 Duplicate key was attempted in a field disallowing duplicate keys. 

One attribute of each key field in a KSAM file is whether or not 
duplicate values are allowed for the key. This status indicates 
that, for a key disallowing duplicate values, a process attempted 
to write to that key a value that is not unique (within the file) 
to that key. 

Diagnostic name: errnodupkey 

233 (WMCS error) A discrepancy in the KSAM code has been detected. 

This status indicates that an error occurred within KSAM. The 
process is not directly responsible for the error. 

Diagnostic name: errksamint 

234 The specified record cannot be locked without causing a deadlock. 

The WMCS cannot lock the specified records without causing a 
deadlock, i.e., a situation wherein each of two processes has a 
record the other process wants to lock of access. 

Diagnostic name: errdeadlock 

235 The specified record (s) are locked by another process. 

The process attempted to access a record locked by another process. 
Diagnostic name: errreclocked 

236 This operation requires that the current record be defined. 

Some KSAM operations require that the current record be defined. 
This status indicates that the required definition was not 
provided. 
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Diagnostic name: errrecnotdef 

237 The process attempted to unlock a record (s) it had not locked. 

The process attempted to unlock on or more records that are not 
locked by the calling process. 

Diagnostic name: errrlocknotl 

238 (WMCS error) A discrepancy in the KPFD linkage has been detected. 

An error occurred within KSAM, an error for which the process is 
not directly responsible. 

Diagnostic name: errkpfdlink 

239 The key does not point to the beginning of an active data record. 
A KSAM key pointer points to a record that has been deleted. 
Diagnostic name: errkeylink 

240 (WMCS error) A KSAM data-structure linkage error has been detected. 

An error occurred within KSAM, an error for which the process is 
not directly responsible. 

Diagnostic name: errnoprocess 

241 An exact match for the specified key value was not found. 

The specified key value (in a call to _JCFIND) was not found in the 
file. 

Diagnostic name: errsrchnotfnd 

242 (WMCS error) A KSAM buffer flushing error was detected. 

An error occurred within KSAM f an error for which the process is 
not directly responsible. 

Diagnostic name: errksamflush 

243 Key- and data-file values for a record's key do not agree. 

The value of key field in the data record, and the value of the key 
in the key file do not match. 

Diagnostic name: errbadkeycmp 
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244 (WMCS error) An error was detected during deletion of a leaf key. 

An error occurred within KSAM f an error for which the process is 
not directly responsible. 

Diagnostic name: errdellink 

245 No error assigned. 

246 One of the parameters specifies an unrecognized option. 

Several KSAM system calls have an option parameter. This status 
indicates that the value assigned to an option parameter does not 
correspond with a recognized function. 

Diagnostic name: errknooption 

247 (WMCS error) A discrepancy in the KFCB linkage has been detected. 

An error occurred within KSAM f an error for which the process is 
not directly responsible. 

Diagnostic name: errkfcblink 

248-253 No error assigned. 

254 (WMCS error) A discrepancy in the Record Locking code has been 
detected. 

An internal recording-locking error occurred. The process is not 
directly responsible for the error. 

Diagnostic name: errrlockint 

255 [CTRL] c terminated the process. 

The process was terminated because it was the last process to 
access a serial port on which a [CTRL] c was received. 

If the process was spawned, this status is sent to the ccode 
parameter of the _CRPROC system call to the parent process. 

Diagnostic name: errcontccode 
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256 The sector header on the disk cannot be read. 

The device was unable to read the header for a disk sector. 
Diagnostic name: errbadheader 

257 The seek or rewind took too long. 

This error is returned when the device reports an error during a 
seek or a rewind operation. 

Diagnostic name: errseekto 

258 The device cannot perform a seek. 

A device check occurred, and a disk seek cannot be performed. 
Diagnostic name: errseekflt 

259 A seek did not reach the proper cylinder. 

This error is reported when a disk device fails during a search 
operation and does not reach the specified cylinder. 

Diagnostic name: errseekwrng 

260 The data in a sector header do not match the CRC or ECC. 

This error is returned when a the data in a sector header on a disk 
does not match the check word (CRC or ECC) that is used to verify 
that data. 

Diagnostic name: errheadcrc 

261 The device cannot perform a recalibration. 

This error is returned when a device fault has occurred during a 
recalibration operation. 

Diagnostic name: errreorgflt 

262 A recalibration took too long. 

This error is returned when a device fault has occurred during a 
recalibration operation. 
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Diagnostic name: errreorgto 

263 The specified device is either off-line, or is not responding. 

The device driver attempted to access the specified device and that 
device did not respond. 

Diagnostic name: erroffline 

264 A device error occurred during a write to the volume write fault) . 
This error is returned when a write fault occurs on a device. 
Diagnostic name: errwriteflt 

265 The specified device is format-protected , and cannot be formatted. 

The device driver's attempt to format the device failed because the 
device is format-protected (this is not the same as write 
protection) . 

Diagnostic name: errformatprot 

266 A device error occurred during a read from the volume (read fault) . 
This error is returned when a read fault occurs on a device. 
Diagnostic name: errreaddataflt 

267 The data on the volume do not match the CRC, ECC, or checksum. 

Each sector or block on a disk or tape contains a check word (CRC, 
ECC or checksum) used to guarantee the validity of the data. If a 
sector or block is read, and the contents of the sector or block do 
not match the check word, this error is returned. 

Diagnostic name: errdatacrcerr 

268 The specified sector was not found on the current track. 
The controller could not find the specified sector. 
Diagnostic name: errseclocate 

269 The specified device is write-protected. 

The process attempted to write to a write-protected device. 

This status is also assigned as a warning when a write-protected 
device is mounted. 
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Diagnostic name: errdevwrtprot 

270 The specified sector number is too large. 

If the specified sector existed, it would be beyond the end of the 
volume. 

Diagnostic name: errsectolarge 

271 The device received a command the device did not recognize. 

This error is returned when the device controller is sent a command 
that it did not recognize. 

Diagnostic name: errbadcmd 

272 The device is not functioning properly (device check) . 

A general device check has occurred; the cause is unknown. 
Diagnostic name: errdevcheck 

273 Data were lost; the driver could not read them quickly enough. 
This error is returned when a data overrun error occurs. 
Diagnostic name: errportovrun 

274 Sector headers could not be found. Is the volume formatted? 

This error is returned when the disk controller did not find sector 
headers on the volume. 

Diagnostic name: errnotformat 

275 The specified device did not respond in the allotted time. 

This error is returned when the device did not respond in the 
expected time. A command was sent to the device, and was not 
completed in a reasonable amount of time. 

Diagnostic name: errdevtimeout 

276 A read-after-write shows a discrepancy in the data. 

A verification of a read-after-write was performed and the data 
read do not match the data written. 

Diagnostic name: errrawf allure 
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277 The tape is positioned at the end of the data on the tape. 

The process attempted to read data that, if they existed, would be 
located beyond the end of the data that do exist on the tape. 

Diagnostic name: errlogicaleot 

278 The tape is positioned at the physical end of the volume. 

The process attempted to write data beyond the physical end of the 
tape. 

Diagnostic name: errphysicaleot 

279 The tape is positioned at the physical beginning of the volume. 

The process attempted to position the tape beyond the physical 
beginning of the tape. For example, the process may have attempted 
to skip five files toward the beginning of the tape when only four 
files were located between the tape's position and the beginning of 
the tape., 

Diagnostic name: errphysicalbot 

280 The size of the block read from the tape is larger than requested. 

The process asked that a block be read from a tape, and the number 
of bytes in the block exceeds the number of bytes requested by the 
process. 

Diagnostic name: errtpoverflow 

281 A parity error was detected in the data on the tape. 

This error is returned when a parity error was detected in the data 
being read from the tape. 

Diagnostic name: errtpparityl 

282 The device wasn't granted access to the bus in the allotted time. 

DMA-type devices request access to the system bus. This status 
indicates that access was not granted within a reasonable time. 

Diagnostic name: errbusto 

283 A parity error was detected in the tape controller. 

A parity error was detected in the dual port memory on the tape 
controller board. Note that this is not a parity error in the data 
on the tape. 
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Diagnostic name: errtpparity2 

284 The specified device was improperly set up. 

The device driver received a function request for a device that has 
not been initialized, e.g., a device driver receives a read 
function request before receiving a startup request. 

Diagnostic name: errnotinit 

285 The device being read was written at a different density. 

The density with which the data were written on the tape does not 
match the data density expected by the controller. 

Diagnostic name: errinvdensity 

286 Connection to a remote computer has not been established. 

This diagnostic is returned to a process which attempts to read or 
write to a modem control port (e.g. X.25) which has no connection 
established to a remote port. 

Diagnostic name: errnocallestb 

287 Connection to a remote computer has already been established. 

This diagnostic is returned to a process which attempts to 
establish a connection on a modem control port which already has a 
connection. 

Diagnostic name: errcallestb 

288 The specified device was improperly set up. 

This diagnostic is returned to a process which attempts to mount a 
port using hardware which is being used by a different driver. 

Diagnostic name: errdevinuse 

289 A deadlock error has been detected on the device. 

This diagnostic is returned when a process attempts to write to a 
port to which no writes are possible because there are no more 
output buffers available, and the input buffers are full. That is, 
"nobody can write until somebody reads". 

Diagnostic name: erriodeadlock 
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290 The X.25 channel has been reset by the network, possible data loss. 

This diagnostic is returned to a process attempting to read or 
write to an X.25 channel which has been reset by the network. This 
is a warning that data may have been lost. 

Diagnostic name: errlinereset 

291 The dial request failed. 

This diagnostic is returned to a process attempting to do a dial 
_4?hsop system call when the dial fails. The process can use 
_getdst to obtain the device status block which contains the reason 
code why the dial failed. 

Diagnostic name: errdialf ailed 

292 The state of the BSC line disallows the specified function. 

The process specified a function that, given the state of the BSC 
line, cannot be performed. 

Diagnostic name: errsyinvlnst 

293 The modem is not ready for communication. 

The modem, attached to a synchronous line, is not in a ready state. 
Diagnostic name: errraodemnotrdy 

294 A bid was received in response to a BSC bid. 

The process issued a bid request to the BSC driver and received a 
different bid on the response line. 

Diagnostic name: errsylnbidrcvd 

295 A NAK was received in response to a BSC bid, poll, or select. 

A NAK was received on the synchronous line in response to a bid, 
poll, or select. 

Diagnostic name: errsynakrcvd 

296 An EOT was received on a BSC line. 

An unexpected EOT was received on the synchronous line. 
Diagnostic name: errsyeotrcvd 
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297 An FVI was received in response to a write on a BSC line. 

The process sent a write on a BSC line and received an WI in 
response . 

Diagnostic name: errsyrvircvd 

298 A disconnect sequence was received on a BSC line. 
Diagnostic name: errsydiscrcvd 

299 None of the devices , on a BSC polling list, responded. 

The BSC driver polled each device specified on the polling list and 
none responded. 

Diagnostic name: errsypollstemp 

300 _3SCL0G's Transfer Log was invoked before Begin Logging. 

The process asked the BSC driver to transfer the contents of the 
log buffer, but did not first use the the Begin Logging Function to 
initiate the log buffer. 

Diagnostic name: errsynodblog 

301 The driver transferred unverified data to the process. 

The process requested data and the BSC driver sent unverified data 
to the process. Data are unverified when the driver has not 
compared the data to the check word. 

Diagnostic name: errsynoverread 

302 A conversational reply was recevied in response to a BSC write. 

The BSC driver received an unexpected conversational reply, e.g., 
bid, in response to a write. 

Diagnostic name: errsyconvreply 

303 The last (no-verify) read did not succeed. 

The BSC driver transferred unverified data to a process and then 
found the data to be erroneous. 

Diagnostic name: errsyprevread 

304 The last (no-wait) write did not succeed. 
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The calling process did not wait for the requested transmission 
from the BSC driver. 

Diagnostic name: errsyprevwrite 

305 Only part of the driver's transmission block was transferred. 
The BSC driver assigns this status as a WARNING. 
Diagnostic name: errsypartread 

306 The BSC transmission block is larger than the driver's buffer. 
The transmission block is too large for the BSC driver. 
Diagnostic name: errsybufovflw 

307 A WAK was received in response to a BSC bid, poll, or select. 
The BSC driver received an unexpected WAK. 

Diagnostic name: errsywackrcvd 

308 The size of the device driver does not match its expected size. 

At the front of each device driver is a length. When a device is 
mounted the device driver for that device is loaded into the 
system. If the OS gets an error reading the driver, this error is 
returned. 

Diagnostic name: errcantreaddsr 

309 A BSC line is no longer synchronized. 

The BSC driver assigns this status when a synchronous line drops 
out of synchronization. 

Diagnostic name: errsydropsync 

310 _3SCPQL's parameter block is incorrect. 

A syntactical error was discovered in the parameter block. 
Diagnostic name: errsyinvprrablk 

311 A value in at least one field of the devicename is disallowed. 

The system's hardware does not include anything corresponding to 
the value appearing in the drive number field of the specified 
devicename, e.g., an attempt to mount _TE99 when a 99th serial port 
does not exist. 

B-45 



Glossary of WMCS Diagnostic Messages 

Diagnostic name: errinvdrvnura 

312 The PC board for the specified device is not installed. 

The driver received a bus error while attempting to access the 
specified device. 

Diagnostic name: errnohardware 

313 Ihe hangup cannot take place, files are still open on the device. 
No longer used. 

Diagnostic name: errdiscfilsopn 

314 Ihe device driver does not contain the code to be downloaded. 

This diagnostic is returned when a process attempts to mount a port 
that requires download code, and the download code is not present 
in the driver file. 

Diagnostic name: errnodwnldcode 

315 The WIOOM board has been restarted and all calls were cleared. 

This diagnostic is returned to each process that attempts to access 
a port without first closing and reopening the port following a 
hardware failure on the Wicom board which clears all calls. 

Diagnostic name: errboardreset 

316 The contents of the dial buffer are missing or invalid. 

This diagnostic is returned to the process making a dial _physop 
call if the length of the dial buffer is zero or if the contents of 
the buffer are not appropriate for the line type. 

Diagnostic name: errinvdialbuf 

317 The driver cannot use this version of the drive type table. 

There is a drive type table stored in the boot block of each disk 
device. One field of the drive type table is a version number. 
The disk device drivers are keyed to specific versions of this 
drive type table. If the driver reads the boot block and discovers 
that the version number is not a version that the driver 
recognizes, this diagnostic is returned. 

Diagnostic name: errbaddrtptbl 
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318 The SCSI port is already busy on select. 

When the hardware device port was sent a select command , it was 
already busy. 

Diagnostic name: errscsibusy 

319 No SCSI request after select. 

After issuing a select command to the hardware device, it did not 
respond with a request. 

Diagnostic name: errnoscsireq 

320 The SCSI controller is in the wrong phase. 

The device controller is in the wrong phase to receive the type of 
command received. 

Diagnostic name: errscsiphase 

321 Error detected while requesting SCSI error status. 

An error occurred during the process of requesting extended error 
status from the device. 

Diagnostic name: errreqscsistat 

322 SCSI port hardware error. 

An error occurred in the hardware port of the device. 
Diagnostic name: errscsiporthd 

323 SCSI error detected with no error status. 

An error was detected in the device controller , but no error status 
followed to define the error. 

Diagnostic name: errscsinostat 

324 No index signal. 

No index signal was detected on the device to synchronize with. 
Diagnostic name: errscsinostat 

325 No track zero. 
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The disk controller was unable to detect where track zero should 
begin. 

Diagnostic name: errnotrkzero 
326 Multiple Winchester drives selected. 

More than one Winchester driver has been selected at the same time. 

Diagnostic name: errscsimanydev 
327-383 No error assigned. 

Utility Diagnostic Messages 

384 A character in the specified accept sequence is disallowed. 

The specified accept sequence (a character string beginning with a 
backslash, __\) is syntactically incorrect. 

Diagnostic name: errinvacceptsq 

385 No more file designations match the specified wildcard pattern. 

The list of files, matching the specified wildcard pattern, has 
been exhausted. 

Diagnostic name: errnomorefiles 

386 No file designations match the specified wildcard pattern. 

The specified wildcard pattern does not match any files in the 
directories searched. 

Diagnostic name: errnofilesfnd 

387 One or more parameter value (s) is longer than 255 characters. 

Neither the command line parser nor the WMCS utilities can 
accommodate a parameter containing more than 255 characters. 

Diagnostic name: errclparamlong 

388 There are more than nine parameters to the parameter file. 

No more than nine parameters can be assigned to a parameter file. 
Note that this restriction does not pertain to the number of 
parameters to the WMCS utilities. 
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Diagnostic name: errtonanyprm 

389 Too many parameter values were specified. 

The number of values specified for the required and optional 
parameters to a particular WMCS utility does not correspond to the 
number of parameters expected. This status indicates that too many 
parameter values were specified for a particular CIP command (on 
the command line f in a command file, or in a parameter file) . 

Diagnostic name: errtomanyreq 

390 The specified switch is not recognized. 

At least one of the specified switches is not recognized, e.g., the 
spelling or abbreviation is incorrect. 

Diagnostic name: errclunknownsw 

391 An unacceptable value was specified for this switch. 

The value assigned to a value switch is either unacceptable or 
unrecognizable. 

Diagnostic name: errclinvswval 

392 The abbreviation of the specified switch is ambiguous. 

The command line parser could not determine which of two or more 
switches was intended, e.g., if a utility has :ABCD and :ABCE as 
switches and you type :ABC on the CIP command line, the command 
line parser cannot determine which of the two switches is intended. 

Diagnostic name: errclnonunqsw 

393 This switch was specified twice; the first occurrence is used. 

The same switch is specified more than once on a single command 
line, or in a single parameter file. 

Diagnostic name: errclmultsw 

394 A required parameter was not specified in the parameter file. 

There are fewer parameters in the parameter file than there are 
required parameters to the command. 

Diagnostic name: errclmissprm 
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395 An error occurred when the process attempted to create SYS$EKROR. 
The process received an error while attempting to create SYS$ERROR. 
Diagnostic name: erropensyserr 

396 The operation cannot be performed on a file of this type. 

Some WMCS utilities operate on certain kinds of files, e.g. , image 
files, directory files, data files, etc. The specified file is not 
of the kind required by the utility. 

Diagnostic name: err invf type 

397 The specified directory cannot be deleted; it contains files. 

The specified file is a directory file that has files in it; only 
empty directories can be deleted. 

Diagnostic name: errnodeldir 

398 Multiple command lines are not allowed for this operation. 

This status results when the command line character string or the 
parameter file contains multiple command lines, and the utility 
does not support multiple command lines. 

Diagnostic name: errmultcmdln 

399 No such command is defined for this operation. 
Diagnostic name: errinvcmd 

400 The specified switch is not of the expected type. 

Either a value switch was specified and no value was assigned, or a 
boolean switch has a value assigned to it. 

Diagnostic name: errinvswtype 

401 The syntax of the specified date and time is incorrect. 

Either the date, time, or both the date and the time were 
incorrectly specified, e.g. , a keyword is unrecognizable, an 
unacceptable delimiter was used, etc. 

Diagnostic name: errinvdate 

402 Conflicting function switches were specified. 
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For utilities that have function switches, at roost one of the 
switches may be specified in any given command. This diagnostic is 
reported when more than one function switch was specified. 

Diagnostic name: errinvsetsw 

403 There is not enough space on the volume to accommodate the request. 

This diagnostic is reported by the dinit utility when it cannot 
write the file system to the volume with the parameters specified. 
For instance , if the operator specifies a value for the :fcbsize= 
switch which will not fit on the volume this diagnostic is 
reported. 

Diagnostic name: errinsuf space 

404 The :edit= switch syntax did not match Strl:str2,str3:str4, etc. 

This diagnostic is reported when the value of the :edit= switch is 
syntactically incorrect. 

Diagnostic name: errinvedit 

405 The : protection switch syntax did not match S:DWRE,P:DWRE, etc. 

This diagnostic is reported when the value of the : protection 
switch is syntactically incorrect. 

Diagnostic name: errinvprotect 

406 The UIC syntax did not match [xxxx,xxxx] . 

This diagnostic is reported when the specified UIC is syntactically 
incorrect. 

Diagnostic name: errinvuic 

407 The range specification syntax did not match n or n-m or n- . 

This diagnostic is reported when the syntax of a range of numbers 
is syntactically incorrect. 

Diagnostic name: errinvrange 

408 The data received do not match the original data transmitted. 

The USSGOFY utility reports this diagnostic when it cannot 
successfully send or receive a packet after the specified number of 
retries. 
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Diagnostic name: errtransmit 

409 The remote station's response does not relate to the transmitted 
data. 

The USSCOPY utility reports this diagnostic when it receives a 
packet that does not correspond to the current context. The two 
USSCOPY processes are not synchronized. 

Diagnostic name: errsynchronize 

410 The remote station did not respond in a reasonable amount of time. 

The USSOOPY utility will report this diagnostic when it does not 
receive a packet from the opposite station within the specified 
timeout. It waits for a packet with the specified timeout for the 
specified number of retries before this error is reported. 

Diagnostic name: errnoresponse 

411 The specified switch is disallowed in this context. 

Some utilities have combinations of switches and parameters that 
are mutually exclusive. When an invalid combination of switches is 
specified, this diagnostic is reported. 

Diagnostic name: errinapprsw 

412 The specified username does not exist. 

The specified username was not found in the SHORTUAF.DAT file. Use 
the WHO command to obtain a list of authorized usernames. 

Diagnostic name: errinvuser 

413 Fixed-length records cannot be converted to a different length. 

This diagnostic is displayed by the TCOPY utility when there is a 
numeric value assigned to both the :srceform= switch and the 
:destform= switch, and the two values are not equal. TOOPY is not 
capable of "reblocking" the file. That is, you cannot use TCOPY to 
convert fixed-length records of one record size to fixed-length 
records of another record size. 

Diagnostic name: errinvconvert 

414 The record size must divide evenly into the block size. 

The block size specified in the TCOPY utility must be an even 
multiple of the specified record size. If it is not, this 

B-52 



Glossary of WMCS Diagnostic Messages 

diagnostic appears. For instance, if the record size is 132, the 
block size can be any multiple of that record size (132, 264, 396, 
528, 660, ...) . 

Diagnostic name: errinvrecsize 

415 The :privilege= switch syntax did not match SYSTEM, SEEPRIV, etc. 

The :privilege= switch may be followed by any combination of the 
following keywords (or unique abbreviations thereof) separated by 
commas. If any of these syntax rules are violated, this error is 
reported. 

setpriv nosetpriv system nosy stem 

readphys noreadphys writephys nowritephys 

setprior nosetprior chngsuper nochngsuper 

bypass nobypass operator nooperator 

altuic noaltuic world noworld 

group nogroup all none 

network nonetwork 

Diagnostic name: errinvpriv 

416 A parameter contains a wildcard character where they are not 
allowed. 

A wildcard character was found in a parameter where wildcards are 
disallowed. Possible wildcards are asterisk, *, equal sign, =, 
square brackets, [] , and parentheses, . 

Diagnostic name: errinvwild 

417 The specified pipe command is invalid. 

This diagnostic is displayed when the command line contains an 
invalid usage of the pipe character, e.g. , > dir I 

Diagnostic name: errinvpipecmd 

418 The syntax of the specified pattern is incorrect. 

The pattern specified as a parameter to the SCAN utility is 
syntactically incorrect. 

Diagnostic name: errinvpattern 

419 There is not enough space in the file to accommodate the request. 

This diagnostic is reported when the user requests that a file be 
inserted or replaced within an existing archive file and if either 
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the specified archive file cannot contain any more files (the 
archive directory is full) or there is not enough space within the 
archive file to accommodate the new file. 

Diagnostic name: errarchfull 

420 The values in the setup file are invalid or out of range. 

This diagnostic is reported when a process reads a setup file and 
discovers that the contents are inappropriate. 

Diagnostic name: errsetupfileinv 

421 The specified drive type was not found in the drive type file. 

The utility searched the DISK. CFG file for a record corresponding 
to the specified drive type, and did not find one. 

Diagnostic name: errdrtypnotfnd 

422 The specified device had no drive type listed for it. 

The utility checked the record in the DEVCONFIG file for the 
specified device. The record was found/ but the drive type field 
was empty (unspecified) . 

Diagnostic name: errnodrtype 

423 The process was terminated with an error. 

This abort status code is returned by a process to its parent 
process to signal that the child was not successful. For example, 
the COMPILE utility creates a child process to perform the syntax 
check. If errors are found fcy the child process in the syntax 
check, then the child process returns this error to the COMPILE 
utility. 

Diagnostic name: errprcsf allure 

424 The lower bound of the range is greater than the upper bound. 

In specifying a range, the lower bound may not be greater than the 
upper bound. 

Diagnostic name: errbadrange 

425 The specified range falls outside the allowable range. 

The user-specified range is not within the allowable range for this 
operation. 
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Diagnostic name: erroutrange 

426 The keys are not consecutive; a :keytt= switch has been skipped. 

When specifying multiple keys for sorting, the key numbers must be 
consecutive. 

Diagnostic name: errskipkeysw 

427 The FIELJ> modifier cannot be used with binary type fields. 

The FIELD= key modifier for sorting cannot be used with binary type 
fields. 

Diagnostic name: errsrtfldbin 

428 The IGNORELEADING= modifier cannot be used with binary type fields. 

The IGNQRELEADING= key modifier for sorting cannot be used with 
binary type fields. 

Diagnostic name: errsrtignbin 

429 The STARTA3>= modifier must be on a byte boundary. 

The STARTA3>= key modifier for sorting must begin on a byte 
boundary. 

Diagnostic name: errsrtsatbyte 

430 The ENDAT= modifier must be on a byte boundary. 

The ENDAT= key modifier for sorting must begin on a byte boundary, 
rather than within a byte (bit field) . 

Diagnostic name: errsrteattyte 

431 The OFFSET modifier must be on a byte boundary. 

The OFFSETS key modifier for sorting must begin on a byte boundary, 
rather than within a byte (bit field) . 

Diagnostic name: errsrtoffbyte 

432 The sort key requires the field to start on a byte boundary. 

The specified sort key requires the field to begin on a fcyte 
boundary/ rather than within a fcyte (bit field) . 
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Diagnostic name: errsrtposbyte 

433 The sort key requires the length to be a multiple of bytes. 

The specified sort key requires the field to be a multiple of 
bytes, rather than bits (bit field) . 

Diagnostic name: errsrtlenbyte 

434 The sum of STARTA!P= + OFFSET= modifiers must be positive. 

The sum of the STARTAP= and OFFSET= key modifiers for sorting must 
be positive. 

Diagnostic name: errsrtsatoffng 

435 The STARTAT= modifier must be a positive integer. 

The value specified for the STARTAI= key modifier for sorting must 
be a positive integer. 

Diagnostic name: errsrtsatpos 

436 The OFFSET= modifier must be a positive integer. 

The value specified for the OFFSET= key modifier for sorting must 
be a positive integer. 

Diagnostic name: errsrtoffpos 

437 The END&D= modifier must be a positive integer. 

The value specified for the ENDAT^ key modifier for sorting must be 
a positive integer. 

Diagnostic name: errsrteatpos 

438 The LENGTH= modifier must be a positive integer. 

The value specified for the LENGTH= key modifier for sorting must 
be a positive integer. 

Diagnostic name: errsrtlenpos 

439 The FIELD= modifier must be a positive integer. 

The value specified for the FIELD= key modifier for sorting must be 
a positive integer. 
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Diagnostic name: errsrtfldpos 

440 The :REGORDLEN= switch must be a positive integer. 

The value specified for the :REGORDLEN= switch for sorting must be 
a positive integer. 

Diagnostic name: errsrtrecpos 

441 The :MEM0RY= switch must be a positive integer. 

The value specified for the :MEM0RY= switch for sorting must be a 
positive integer. 

Diagnostic name: errsrtmempos 

442 The :MAXRECORDLEN= switch must be a positive integer. 

The value specified for the :MAXRECORDLEN= switch for sorting must 
be a positive integer. 

Diagnostic name: errsrtmaxpos 

443 A field must be at least one bit wide (STARTAT= + LENGTH= > 
ENDAT» . 

The field for sorting defined by the STARTAT=, LENGTH=, and ENDAT= 
key modifiers must be at least one bit wide. 

Diagnostic name: errsrtsatoffgt 

444 The field is not big enough for the given length (LENGTH= > 
ENDAT=) . 

The field for sorting defined by the STARTAT= f LENGTH=, and ENDAT= 
key modifiers is not big enough. 

Diagnostic name: errsrtlengt 

445 A length must be specified. 

A length must be specified for the sort field. No defaults are 
allowed. 

Diagnostic name: errsrtlenO 

446 The key length must be <= 32 bits for BINARY or BIT. 

The length of the key for BIT or BINARY sort fields must be less 
than or equal to 32. 
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Diagnostic name: errsrtlen32 

447 The key length must be <= 64 bits for FLOATINGPOINT or REAL. 

The length of the key for FLOATINGPOINT or REAL sort fields must be 
less than or equal to 64. 

Diagnostic name: errsrtlen64 

448 FLOATINGPOINT or REAL must have a length of 32 or 64 bits. 

The length of the key for FLOATINGPOINT or REAL sort fields must be 
32 or 64 

Diagnostic name: errsrtlen3264 

449 A text file cannot have a record length greater than one (1) byte. 
A text file for sorting must have a record length of one byte. 
Diagnostic name: errsrttxtlen 

450 The delimiter= modifier is required when f ield= is specified. 

If the field= key modifier is specified , then the delimiter key 
modifier must also be specified. 

Diagnostic name: errsrtdelreq 

451 Ihe pattern is too complex. 

!Ihe sort pattern specified is too complex for the SORT program. 
Diagnostic name: errscnpatcraplx 

452 The extension is not recognized. 

The extension of the file is not recognized by the program. The 
program assumes certain file formats and/or contents based on the 
file extension. 

Diagnostic name: errunknownext 

453 The :attribute= switch did not match SWAPPABLE,DESENCRYPT, . .. 

Valid values for the :attribute= switch are: SWAPPABLE,PREZEROMEM, 
POSTZEROMEM, DESENCRYPT, FASTENCRYPT, WATCHDOG, USER1 , USER2 ,USER3 , and 
USER4. No other values may be given for this switch. 
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Diagnostic name: errinvattr 

454 The use rname/ password cannot be validated. 

To successfully access the public/private key file, a valid 
username and password must be supplied. 

Diagnostic name: errinvuserpass 

455 The data checksum is not valid. 

The checksum calculated for the data dees not agree with the 
checksum that was stored with the data. 

Diagnostic name: errinvdatacksura 

456 Error (s) occurred during assembly. 

One or more errors were detected in the source files processed by 
WIMAC. 

Diagnostic name: errasmerr 

457 The terminal type is unsupported by this utility. 

The terminal type that is assigned to this • terminal is not 
supported by this utility. 

Diagnostic name: errunsupportterm 

458 The data read is inconsistent, invalid, or has missing bytes. 

The data that was read by the utility had either inconsistent or 
invalid values in it, or it was detected to be missing some 
required data. 

Diagnostic name: errmissinvdata 
459-4095 No error assigned. 
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Remote System Calls 



The following system calls are known 
can be executed over the network: 



as remote system calls because they 



_alloc 


_andevnt 


_assign 


__chdir 


_clone 


_close 


_clrevnt 


_connect 


_create 


_creats 


_crprcs 


_crproc 


_dealloc 


_defdprt 


_defduic 


_deinst 


_delete 


_dismnt 


_duplun 


_errno 


_exproc 


_flush 


_gassign 


__gengy 


_getalc 


__getattr 


_getdnam 


_getdprt 


_getdst 


_getduic 


_getevnt 


_getfcb 


_getfid 


_getfnam 


_getfprt 


_getf re 


_getfrsz 


_getfuic 


_getglb 


_getinst 


_getlog 


_getmlst 


_getpcb 


_getpid 


_getpnam 


_getpos 


_getpri 


_getprv 


_getrel 


_getrtr 


_gettic 


_gettim 


_gettmsl 


_getuic 


_giodst 


_giaail 


Jiibern 


..install 


_Kclose 


Jcdelet 


_kfind 


Jcflush 


_Kinfo 


_Kmovfb 


Jcopen 


_kread 


_kunlck 


Jtupdat 


Jcwrite 


.JLock 


_mount 


_mulcrps 


_open 


_orevnt 


_origprv 


_physio 


_physop 


_prclst 


_prirat 


_rdpmem 


_read 


_rename 


_setattr 


.jsetdprt 


_jsetdst 


_jsetduic 


_setevnt 


_jsetfcb 


_setfid 


_setfprt 


_setfrsz 


_setfuic 


_jsetpnam 


_setpos 


_setpri 


_setprv 


_setrtr 


_settim 


_settmsl 


_setuic 


_siodst 


_skip 


__smail 


_tranpid 


_unlock 


_version 


_wake 


_wakec 


_write 


_wtpmem 



NOTE: To execute any of these system calls across a network , the 
NETWORK privilege must be set. To execute _clone, _crproc, or 
_jsetattr across a network, the SETATER privilege must be set. 

Remote system calls can receive the following diagnostic messages: 
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errinsufpriv 

errnomemavail 

errinvsiteid 

errundefsvc 

errremotelogon 

errnodevavail 

errnonodefnd 
errnoremcrproc 

errsiteinvalid 

errdupconnect 

errnoconnect 

errnotremotesvc 

errbadpktsize 

errnoremotemem 

errwrongos 

errunknowncmd 

errbuftosmall 

errnonetbufs 

errnositeid 

errnocallestb 

errcallestb 

errdialfailed 



(1) The process lacks the privileges required to 
perform the operation. 

(7) All available memory has been allocated. 

(8) The specified site ID does not exist. 

(43) The WMCS does not recognize the SVC number used 

by the process. 
(47) The process was not allowed to log jn to the 

remote system. 

(52) No network virtual circuits are available for 
this operation. 

(53) The specified node could not be found. 

(55) Remote process creation is not allowed by the 

remote system. 
(57) The site 3D verification failed for the specified 

network node. 

(72) A connect packet was received after the 
connection was made. 

(73) An SVC packet was received bef'>r-e the connect 
packet was received. 

(75) A packet was received for a local-execution-only 
SVC. 

(76) The actual packet size is not the same as the 
size in the header. 

(78) All available memory has been allocated on the 
remote system. 

(79) The process is incompatible with the current 
operating system version. 

(175) The specified device driver function code is 
disallowed. 

(176) The process buffer is tco small for the specified 
operation. 

(184) Not enough network buffers are available for a 

remote connection. 
(194) The network site ID on this machine is 

uninitialized. 

(286) Connection to a remote computer has not been 
established. 

(287) Connection to a remote computer has already been 
established. 

(291) The dial request failed. 
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W1CAT Systems, Inc. 

Product-documentation Comment Form 

We are constantly improving our documentation, and we welcome scecific comments en mis manual 

Document Title: ______ 

Part Number 

Your Position: D Novice user □ System manager 

D Experienced user D Systems analyst 

Q Applications programmer n Hardware technician 

Questions and Comments Page No. 

Briefly describe examoles, illustrations, or information that you think should be added 
to this manual. 



What would you delete from the manual and why? 



What areas need greater emphasis? 



List any terms or symbols used incorrectly. 
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